NetDeck M0: emulator sandbox + design doc

- src/netdeck: DESIGN.md (RTwP cyber-tactical ship crawler for T-Deck),
  STATUS.md milestone tracker, nd_layout.h shared constants
- examples/NetDeck: M0 sandbox — 40x24 ship floorplan and 8-node sub-net
  in one shared coordinate space (door nodes pinned to bulkhead door
  tiles); Cameras/Network view modes via P (network overlaid as dotted
  outlines vs dimmed ship + full graph); trackball cursor (edge ISRs +
  momentum); Space tactical freeze with CRT scanlines; 20 Hz fixed-step
  sim (pause-verified frame-identical); keyboard @ I2C 0x55 groundwork
  for M2-M4
- emulator: APP=NetDeck support + Tab key host mapping
- platformio.ini: NetDeck src_dir ready for firmware build
This commit is contained in:
Dejvino
2026-11-14 10:37:35 +01:00
parent d542d6ffa7
commit 2bfd6c6428
9 changed files with 1063 additions and 0 deletions
+37
View File
@@ -0,0 +1,37 @@
# NetDeck — Breach & Board: Milestone Status
Source of truth for gameplay/architecture: [DESIGN.md](DESIGN.md).
This file tracks milestone progress (DESIGN.md §7). Update it when a
milestone lands.
| Milestone | Scope | Status |
| --- | --- | --- |
| **M0 — Emulator** | SDL2 emulator support + M1 surface tested locally | **done** |
| M1 — Hardware Sandbox | Boot on ST7789 DMA, shared tactical view (Cameras/Network) + HUD, cursor, `Space` freeze, `P` view switch | prepared (emulator-verified, needs device bring-up) |
| M2 — Network Graph & Traces | Node graph in Network view (door nodes on bulkhead tiles), link routing, ICE crack, red trace + `X` sever | planned |
| M3 — Squad vs. Droids | Ship floorplan in Cameras view, 3 marines → beacon, 4 droids, gunfire | planned |
| M4 — Cyber-Physical Bridge | Hive link + `1` FRENZY.EXE turns droids on each other (shared coordinate space) | planned |
## M0 (this milestone)
- `src/netdeck/nd_layout.h` — shared constants: 320x192 tactical view + HUD bar
(one coordinate space), palette, fixed-timestep timings.
- `examples/NetDeck/NetDeck.ino` — sandbox app: 40x24 demo floorplan and an
8-node sub-net graph in the same coordinate space (door nodes pinned to
their bulkhead door tiles); **two view modes** — Cameras (full ship view,
network as dotted outlines) and Network (ship dimmed ~35%, full graph with
labels and packets), switched with `P` (Tab kept as legacy alias); trackball
cursor (edge-ISRs + momentum, tile snap in Cameras / node target in
Network); keyboard @ 0x55 (`Space` freeze, `1-4`/`X`/`R` groundwork);
tap-to-cursor via GT911; 20 Hz sim accumulator (pause-verified
frame-identical).
- Emulator: `make APP=NetDeck run` / `smoke` from `emulator/`; host gained `Tab`
key mapping (`emulator/src/main.cpp`).
## M1 remaining (hardware bring-up, same sketch)
- ST7789 via DMA double-buffered transfers (two 153.6 KB SRAM DMA buffers).
- Real keyboard-controller init timing + stale-byte grace on device.
- Trackball sensitivity on real hardware (`TB_IMPULSE`/`TB_FRICTION` device branch).
- Frame cost check: full 320x240 redraw must fit ~30 fps at 80 MHz SPI; move to
incremental/two-buffer rendering if not.