Documentation¶
Start with PLAN.md for current hardware decisions and open gates.
| Topic | Start here |
|---|---|
| Detailed hardware selections and interfaces | Hardware design reference |
| Ear flexes, connector and design history | Ear documentation |
| Firmware baseline and hardware interface | Hardware/firmware handoff |
| External capacitive electrode test board | AW93x05 breakout, library pin-map audit |
| BX hand-soldering and motion/audio test board | LSM6DSV16BX breakout |
| Shared flex design rules | JLCPCB flex rule profile |
| Headband rigid stack and routing rules | Headband rigid-board setup |
| Headband Gerbers, BOM and CPL for JLCPCB quoting | Headband quote files |
| Two-set rigid headband carrier for Standard PCBA | KiKit headband panel |
| Common detachable microphone flex and manufacturing notes | Mic flex |
| Bare 16-up microphone-flex panel for hand assembly | Mic flex panel |
| Headband outline and rough component placement | Headband layout |
| Single-colour ESPurr icon for band and ear-rear silkscreen | Artwork |
| Headband routing revision after visual review / KiCad crash | Astra handover, 2026-10-27 |
| Routing-tool rule preservation | KiCadRoutingTools |
| MkDocs website, KiBot documentation exports and release render galleries | Hardware website |
CLI, just aliases and tests |
Hardware tooling |
| Native PCB IPC, explicit instance/document binding and verified edit/save isolation | Native KiCad PCB IPC |
| Generated-output retention and cleanup | Build output and cleanup |
| Frozen LED geometry and reproducers | Ear fit records, selected 69-LED record |
| Mechanical reference artwork and attribution | Patterns |
| Library licensing | Library licences |
| Actual order inputs and supplier-file status | Manufacturing orders |
Ear guides live under ears/; dated proposals, reviews and implementation
checkpoints live under ears/archive/. Keep current instructions in the plan
and maintained guides, and link to checkpoint evidence rather than copying it.
Add new ear notes within that structure.
Current ear generation is documented in the pair/panel quote pipeline. Earlier mirror/routing experiments are in the right-generation archive.
Frozen fit data, reproducers, pattern assets and immutable order packages keep
their established locations. Ordinary generated reports, renders and exports
belong under build/.