feat(L01): add number systems and storage card

2026-07-21 18:58:00 +02:00
commit 6c9e07abdf
42 changed files with 7303 additions and 0 deletions
@@ -0,0 +1,23 @@
+# L01 · Number Systems and Storage
+
+Pierwsza karta serii **ASM · RV32I From Blinker to RISC-V** buduje język,
+który będzie używany przy instrukcjach, natychmiastowych argumentach i pamięci.
+Uczeń przechodzi od wag bitów przez rozszerzenia i przesunięcia do zapisu słowa
+RV32I w pamięci little-endian.
+
+| Task | Mierzalny dowód |
+| --- | --- |
+| `task01_positional_encoding` | `173 = 10101101₂ = AD₁₆` i suma wag 173 |
+| `task02_extension_shifts` | zero/sign extension oraz logiczne/arytmetyczne `>> 1` dla `0x80` |
+| `task03_little_endian_memory` | `0x12345678` zapisane jako bajty `78,56,34,12` i poprawny roundtrip |
+
+```bash
+stemctl card use rv32i-asm L01
+stemctl test native-amd64 rv32i-asm L01 1
+stemctl test hazard3-sim rv32i-asm L01 2
+stemctl debug hazard3-sim rv32i-asm L01 3
+```
+
+Profil `native-amd64` uruchamia niezależny model referencyjny. Profil
+`hazard3-sim` wykonuje self-checking SystemVerilog i w akcji `debug` zapisuje
+VCD. Karta nie wymaga płytki FPGA.