# ASIC donut ## What this builds A tiny, original rotating torus, in Verilog, aimed at a tiny-ASIC-shaped gate or tile budget. A testbench dumps frames of a full turn. Golden dumps are compared. A size cap is checked with a documented script. No tapeout, no FPGA, and no board are required. This is not a copy of a particular silicon-demo's code. Read `spekkr.inputs.json` first. `width` and `height` size the buffer. `frames` is a full turn. `shading` and `letterbox` change the picture. `sim` is the simulator. ## Out of scope - A real tapeout, a shuttle, or an FPGA board in the checks. - A vendor's PDK licence in the checks. - A copyrighted demo's code. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. The loop - The testbench dumps `frames` frames of a complete turn. Frame 0, a quarter turn, and a half turn match goldens, exact or within the file's tolerance. - The last frame, followed by one more step, matches frame 0 (a closed loop), within the same tolerance. - Two runs hash the same dumps. Accept when: the three goldens match, the loop closes, and two runs hash equal. ### R2. Cap and files - A documented count script reports a figure at or under the bound in `design.md` (a tiny-ASIC-like budget, for example a 4k-gate or a one-tile bound, as the file states). - Renders: frame 0, quarter, half, and a strip of the loop. One command simulates, counts, and writes the dumps. No tapeout. Accept when: the cap holds, the command passes for both simulators, and a too-large fixture exceeds it. ### R3. Inputs - Inputs are read from `spekkr.inputs.json`. Values outside the ranges or choices in `design.md` are refused before a netlist, a board or a testbench is built. - Options turn the optional circuits, ports or features in the Inputs table on or off. Accept when: an illegal input is refused by name, and the default input set produces the measurements in `design.md`. ### R4. Checks and report - One command runs the simulation or the testbench, writes the plots or dumps, and compares them to the numbers in `design.md`. - The command works without a physical board, a lab instrument or a network. Accept when: the command passes at the defaults, and fails if a documented value in the netlist or the ROM is corrupted on purpose. ## Verification A testbench dumps a deterministic rotating torus; frame 0, a quarter, and a half match goldens, and the loop closes. A documented size cap is checked. No tapeout, no FPGA, and no board are required. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to simulate, how the cap is counted, and that a tapeout is optional.