# Design This file fixes the circuits, the timings and the dumps a build must match. The toolchain can vary, as long as the numbers here hold. ## Framebuffer 64 by 32 bits, 1-bit pixels, origin top-left, as in the classic interpreter. PNG dumps scale each bit by `scale`. ## ROMs Only ROMs with rights in `LICENCE.md` or in the fixtures note. Cycle counts and expected hashes are the file. ## Timers Delay and sound timers decrement at 60 Hz in virtual time, as in the file's clocking note. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `cycles` | Cycles to run | 20000 | A default cap for a fixture, from 1000 to 200000. | | `scale` | Dump scale | 4 | How many pixels a CHIP-8 pixel becomes in a PNG, 2, 4 or 8. | | `super` | A documented Super extension | off | Only if a fixture ROM needs it; default is classic CHIP-8. | | `sound` | A sound flag | on | The sound timer is dumped; no speaker is required. | | `sim` | Simulator | verilator | Either must pass the same ROMs and dumps. | ## Acceptance at the defaults A classic CHIP-8 core in HDL. The display is 64 × 32. A tiny original fixture ROM is the authority, not a copyrighted game. | Quantity | Value | Tolerance | Source | | --- | --- | --- | --- | | Display | 64 × 32 | exact | 1-bit pixels | | Memory | 4096 bytes | exact | Program starts at 0x200 | | Timers | delay and sound, 60 Hz | — | Sound is a flag; no speaker | | Fixture ROM | `roms/dot-and-line.ch8` | — | Draws a dot, then a line | | Golden frames | after 10, 50, 200 cycles | exact | Of that ROM | The Super extension is off by default. The testbench clocks the core, dumps the display and the timers, and compares the three frames. A second, documented opcode smoke test covers ADD, JP, SE, LD Vx, and DRW. ## Screenshots These pictures are dumps of a working reference model of the core, in `reference/preview.py`, at the default inputs. They are not drawings of a product that has not been built or simulated. The first picture is the one Spekkr shows on the spec's card. A build may ship its own goldens; those goldens are of that build and do not have to match these frames pixel-for-pixel. | File | What it shows | | --- | --- | | `shots/after-10.png` | CHIP-8 display 64 × 32, a dot after 10 cycles | | `shots/after-50.png` | CHIP-8 display 64 × 32, a dot and a line after 50 cycles | ## How to verify 1. Run the simulation or the HDL testbench at the defaults, with no physical board. 2. Compare periods, trip points, register dumps or frames to the acceptance table in this file. 3. Corrupt one documented value on purpose and confirm the check fails. 4. Test ROMs you have rights to, and an original fixture program, produce golden framebuffer dumps (or hashes) after a documented cycle count. A rights scan fails if a commercial dump is present. No FPGA and no handheld are required.