Hardware
The physical build: bill of materials, assembly plan, mechanical layout, electrical paths, component sourcing.
System-level
Section titled “System-level”canonical-spec.md— the Canonical Hardware Specification: the single source of truth for every hardware value.build-specification.md— top-level BOM, assembly plan, hardware topology, dev-vs-prod-mode.wiring-diagram.md— block-level system wiring (power, data, audio, input) as a Mermaid diagram.sourcing-guide.md— component sourcing notes, candidate part families, vendor links, supplier risk.shopping-list.xlsx— the buy list (binary; opaque to the audit).
Per-component specs
Section titled “Per-component specs”One page per major hardware subsystem. Each page consolidates the relevant ADRs + the BOM rows + the bring-up steps for that subsystem.
processor.md— Raspberry Pi Zero 2 W (primary processor: Linux, nOSh, HDMI, USB hub host).coprocessor.md— Raspberry Pi Pico 2 (RP2350) realtime I/O coprocessor (audio + auxiliary OLED).primary-display.md: Elecrow 7” IPS driven by the native framebuffer renderer (ADR-0036); geometry percanonical-spec.md.auxiliary-display.md— CIPHER-LINE OLED; see the parent canonical spec for hardware values and the GWP-619 bench note for the temporary 8080 harness.keyboard.md: Ferris Sweep 34-key split (holykeebs Soldered kit), Kailh Choc v1 hot-swap, MBK keycaps, 2× KB2040, 2× trackpoint, QMK (ADR-0031 / ADR-0032 / ADR-0062).audio.md— YM2149 PSG → I2S → WM8960 codec → Gikfun 2″ speaker / 3.5 mm stereo headphone jack.cartridge-interface.md— SD card in custom clamshell sled, USB-MSC bridge IC.power.md— Waveshare UPS Module 3S (3× 18650) → 5 V/5 A rail (whole device incl. display), 12.6 V barrel-jack charge, INA219 battery monitor (ADR-0038); runtime envelope.enclosure.md— Pelican 1170 + 3D-printed inset panels (Pelican shell unmodified).
Related
Section titled “Related”device/os/— what gets flashed onto the assembled device.adr/ADR-0036: the native framebuffer renderer, carrying the current display profile and geometry (supersedes ADR-0027, which supersededADR-0014).adr/ADR-0015— CIPHER-LINE auxiliary OLED.adr/ADR-0017— realtime I/O coprocessor.adr/ADR-0031: Ferris Sweep adoption, layout, and consequences; withADR-0032(trackpoints),ADR-0044(KEC-complete shift manifest), andADR-0062(three printed layers).ADR-0018supplies the commodity-parts build pattern; its custom-PCB path is superseded.adr/ADR-0019— cartridge storage + form factor.- Canonical Hardware Specification — every hardware value lives here first.