# PM_K-1 EDA environment

A reproducible container with the tools to design, check, and simulate the core board —
so the work doesn't depend on whatever happens to be installed on a given machine, now or
in 50 years.

## What's inside
- **KiCad 9** — schematic capture + PCB layout, and a CLI (`kicad-cli`) that can run
  **ERC** (Electrical Rules Check) and DRC, and export netlists/PDF/Gerbers.
- **ngspice** — SPICE simulator for validating the analog audio circuits before we commit
  copper (op-amp stages, filters, input loading, etc.).
- **python3** — scripting, BOM munging, optional code-defined-schematic helpers.

## Why a container?
The system KiCad here is 7.0, whose CLI can't run ERC (that arrived in KiCad 8). Rather than
fight the host, we pin a known toolchain. Anyone — including future-you — rebuilds the exact
environment with one command.

## Use it
```bash
cd hardware/eda
./run.sh                                   # interactive shell, lands in hardware/kicad/
./run.sh kicad-cli version                 # confirm KiCad 9
./run.sh kicad-cli sch erc pm_k1_core.kicad_sch   # run ERC on the schematic
./run.sh ngspice -b ../eda/sim/input_loading.cir  # run a simulation (cwd is kicad/)
```
`run.sh` builds the image on first use, then mounts the whole repo at `/work` (so KiCad sees
`hardware/`). Use `RUNTIME=docker ./run.sh …` to use Docker instead of Podman.

## Layout
```
eda/
  Containerfile      # the pinned toolchain (KiCad 9 + ngspice + python)
  run.sh             # build-if-needed + run with the repo mounted
  sim/               # ngspice decks (SPICE simulations of the analog circuits)
```