# 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. ## Nets The file lists every required net and the pins that must be on it. USB-C, if on, follows the documented power pins only (no high-speed requirement in this version). ## Rules ERC and DRC rule files (or a KiCad design-rule set) are shipped. Waivers, if any, are listed by code. ## Outline Origin and mounting inset (4 mm from two edges, or as in the file) are `fixtures/board-outline.json`. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Board title | A small instrument | Drawn in the silkscreen title block. | | `width` | Board width, mm | 80 | From 40 to 160. | | `height` | Board height, mm | 50 | From 30 to 120. | | `usb` | A USB-C power input | on | A documented connector and a simple protection network. | | `mounts` | Mounting holes | on | Four holes, M3, at the documented inset. | | `tool` | Toolchain | kicad | kicad uses KiCad files generated from code. code-first uses a named board-as-code tool that still emits a netlist and a PCB the checks can read. | ## Acceptance at the defaults Millimetres and nets. Default board 80 × 50, two layers, USB-C power and four M3 mounts on. The board is generated from code. | Quantity | Value | Tolerance | Source | | --- | --- | --- | --- | | Board size | 80.00 × 50.00 | 0.05 | Outline | | Thickness | 1.60 | 0.05 | A 1.6 mm two-layer stack | | Mounting holes | 4 × M3, inset 3.5 from corners | 0.10 | When `mounts` is on | | USB-C cutout width | 9.00 | 0.10 | When `usb` is on | | Minimum copper clearance, track | 0.20, 0.25 | 0.02 | Except a documented pour neck | A snapshot of the generated board (SVG or KiCad) is compared to a golden for the default inputs. ERC is clean aside from a documented list. No board house and no physical board are required. ## 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/board.png` | Board 80 × 50 mm, two layers, USB-C and four M3 mounts | ## 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. Netlist assertions, ERC, and DRC are run on a board generated from code. The outline and mounting holes are measured. Board renders are written. A deliberate short fails ERC. No fabricator, no parts order, and no programmer are required.