feat(L02): add FPGA bring-up and programming card

2026-07-21 18:58:00 +02:00
commit 48f3fb738b
44 changed files with 7302 additions and 0 deletions
@@ -0,0 +1,28 @@
+# L02 · FPGA Bring-up and Programming
+
+Karta ustanawia bezpieczną drabinkę od kontraktu płytki do obserwacji LED:
+polaryzacja sygnałów → działający blinker w symulacji → kabel → identyfikacja
+układu → konfiguracja → fizyczna obserwacja.
+
+Repozytorium celowo zawiera [szablon kontraktu](board/board-contract.yaml), a
+nie zmyślone piny. Przed budową bitstreamu operator musi podać rzeczywisty
+model płytki, FPGA, częstotliwość, piny i programator.
+
+| Task | Automatyczny dowód |
+| --- | --- |
+| `task01_pin_polarity` | jawne active-low reset, button i LED |
+| `task02_bringup_blinker` | znany reset i krawędzie LED co 4 takty |
+| `task03_programming_gate` | kolejność cable → id → configure → observe |
+
+```bash
+stemctl card use rv32i-asm L02
+stemctl test native-amd64 rv32i-asm L02 1
+stemctl test hazard3-sim rv32i-asm L02 2
+stemctl debug hazard3-sim rv32i-asm L02 3
+```
+
+Komunikat `PASS task03` oznacza wyłącznie przejście modelu preflight i zawsze
+raportuje `hardware_observed=0`. Nie jest dowodem zbudowania bitstreamu,
+połączenia programatora ani działania fizycznej LED. Te dowody należy wpisać
+do [answers/fpga-bringup-evidence.md](answers/fpga-bringup-evidence.md) po
+wykonaniu na wskazanej płytce.