# 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. ## Mapping Tiles or walls become traces of width `trace` on a documented grid, in `fixtures/trace-map.json`. Footprints may stand in for entities, as listed. The playfield net may be a single net, with that waiver named. ## Demo 8 frames, or as in `fixtures/trace-demo.json`. Goldens are board renders or a simple SDL/wireframe, as the file says. ## Rights Only original or permissively licensed art. No commercial IWAD. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `width` | Playfield width, mm | 100 | From 60 to 160, the board's play area. | | `height` | Playfield height, mm | 80 | From 40 to 120. | | `trace` | Trace width, mm | 0.3 | From 0.15 to 0.8, the copper used as 'ink'. | | `silk` | Silkscreen labels | on | A title and a life count, as silk, not as copper. | | `frame` | A copper frame | on | A border on the playfield. | | `view` | Play view | top | top is a top-down maze or field. first-person is a simple corridor, still drawn as traces. | ## Acceptance at the defaults A small game whose playfield is copper traces and footprints. The board is generated as SVG or KiCad, and a script plays a short fixture game on the traces. | Quantity | Value | Tolerance | Source | | --- | --- | --- | --- | | Board size | 100.00 × 70.00 | 0.10 | A single-layer playfield plus a ground border | | Trace width | 0.80 | 0.05 | Of the path the 'token' follows | | Lives, default | 3 | 0 | Silk label when `silk` is on | | Fixture play, length | 12 moves | 0 | `fixtures/trace-game-12.json` | | ERC | clean, or a documented list | — | No board house required | Four goldens: the bare board, the board with silk, mid-play after move 6, and a game-over frame. The game logic may run in Python against the generated geometry; the copper itself is the map. ## Screenshots These pictures are a board generated from the reference script in `reference/board.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/bare-board.png` | Playfield 100 × 70 mm, copper traces and a silk title | | `shots/mid-play.png` | Mid-play after move 6, two lives left | ## 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. A scripted demo produces golden frames and a .kicad_pcb snapshot whose traces and footprints match a documented mapping. ERC is clean enough for the stated few-net demo, with waivers listed. A rights scan fails if a copyrighted commercial IWAD is present. No board house is required.