Implements MVP.md §1-§3 (network half of the vertical slice) on the shared coordinate space: - 3-room floorplan (airlock/corridor/server room) with blast door + terminal - 4 nodes: AIRLK root - JUNC - DOOR_CTRL (on the door tile) / HIVE (3s ICE) - animated link builds (dotted->solid, 1.5s plain / 3.0s ICE), reachability tree from AIRLK; links offline until the build completes - DOOR_CTRL toggles the blast door; X severs the hovered link (ICE progress resets, trace cut short resets safely) - cracking HIVE spawns a 4s red trace to AIRLK; arrival = feedback spike: links drop + 3s OVERHEAT lockout (TEMP bar) - FRENZY/BLIND daemon slots gated on HIVE link (effects land in M4) - R instant reset via resetScenario() (also fixes root-online init bug) - boot straight into the paused encounter - emulator: --tap "x,y@frame" and repeatable --type "text@frame" for headless scenario testing Verified headlessly: full trace->feedback run, safe sever, all gating messages, reset; visual dumps inspected. Spec: src/netdeck/MVP.md.
5.2 KiB
5.2 KiB
NetDeck — Breach & Board: Milestone Status
Source of truth for gameplay/architecture: 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 | Full-frame sprite rendering to ST7789, shared tactical view + HUD, cursor, Space freeze, P view switch |
compiled + emulator-verified; on-device check pending |
| M2 — Network Graph & Traces | 4-node sub-net in shared space (AIRLK→JUNC→DOOR/HIVE), animated link routing (1.5 s / 3.0 s ICE), door control, red trace → feedback spike + OVERHEAT, X sever, R reset |
done (emulator-verified) |
| 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 (done)
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 withP(Tab kept as legacy alias); trackball cursor (edge-ISRs + momentum, tile snap in Cameras / node target in Network); keyboard @ 0x55 (Spacefreeze,1-4/X/Rgroundwork); tap-to-cursor via GT911; 20 Hz sim accumulator (pause-verified frame-identical).- Emulator:
make APP=NetDeck run/smokefromemulator/; host gainedTabkey mapping (emulator/src/main.cpp).
M1 (this milestone)
- Flicker-free full-frame rendering (
examples/NetDeck/NetDeck.ino): all drawing goes into a RAM second buffer —TFT_eSprite fb(PSRAM, 320x240x16) on device, the SDL shim framebuffer in the emulator — and is pushed as one continuous SPI stream (present()→startWrite() / fb.pushSprite(0,0) / endWrite()), the proven MiataDrive anti-tearing pattern (commitd542d6f). - Firmware build: self-contained
examples/NetDeck/platformio.ini(pio run -d examples/NetDeck; board + libs resolved against the repo rootboards/andlib/). ESP32-S3 / arduino-esp32 2.0.9: RAM 6.7%, Flash 5.5%, binary atfirmware/NetDeck_M1_261114.bin. - Keyboard bring-up: stale-byte flush from the 0x55 controller at boot end (before the first frame), on top of the 1400 ms boot grace.
- Trackball device branch:
TB_IMPULSE/TB_FRICTIONconstants split for device vs emulator edge rates. - Emulator frames are pixel-identical to the M0 baseline (regression verified: cameras / network / freeze / beacon click).
Flashing + on-device checklist (needs the physical T-Deck)
pio run -d examples/NetDeck -t upload(or flashfirmware/NetDeck_M1_261114.bin).- Boot screen
M1 // SANDBOXshows for 1.4 s, then the Cameras view. Pflips to Network view (dimmed ship + labeled graph),Tabtoo.Spacefreezes (CRT scanlines, sim/packets halt); cursor stays live.- Trackball: smooth momentum cursor, tile snap in Cameras, node targeting in Network; Enter = beacon drop / node select; screen tap works too.
M2 (done — emulator-verified)
Implements the sub-net half of the MVP vertical slice (MVP.md §1–§3,
validation spec added in this commit) on the shared 320x192 coordinate space:
- 3-room floorplan (airlock / main corridor / server room) with the
Room2/Room3 blast door (
+) and the objective terminalT. - 4-node sub-net pinned to map tiles: AIRLK root (always online) — JUNC — DOOR_CTRL (on the blast door tile) / HIVE (3 s ICE). Click an adjacent offline node to route a link: animated dotted line turning solid over 1.5 s (3.0 s through ICE); offline until the build completes.
- DOOR_CTRL (once online) toggles the blast door open/closed — open doors also un-block LOS/movement for the combat milestone.
Xsevers the hovered link (distance cursor→segment): everything beyond it drops, ICE progress resets; severing during a trace resets the trace safely.- Red trace: cracking HIVE spawns a 4 s red pulse back to AIRLK;
arrival = feedback spike → all links drop + 3 s OVERHEAT lockout
(
TEMPbar). FRENZY/BLIND daemons are gated until a HIVE link is up (effects land in M4). Rresets the scenario instantly to the paused, re-armed state (resetScenario()), which also fixes the AIRLK-root-online bug.- Boot goes straight into the paused encounter; HUD shows daemon slots,
TEMP bar, and
R: RESET. - Emulator host (
emulator/src/main.cpp): headless testing support — repeatable--tap "x,y@frame"screen-tap injection and repeatable--type "text@frame"scheduled keyboard input. - Verified headlessly: full route→door→ICE→trace→feedback→cooldown run,
safe-sever run (trace reset, no spike), all gating messages
(NO HIVE LINK / NO UPLINK / OVERHEAT / LINK SEVERED / NO NODE),
and
rreset; visual frame dumps inspected.