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.
91 lines
5.2 KiB
Markdown
91 lines
5.2 KiB
Markdown
# 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** | 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 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 (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 (commit d542d6f).
|
|
- **Firmware build**: self-contained `examples/NetDeck/platformio.ini`
|
|
(`pio run -d examples/NetDeck`; board + libs resolved against the repo
|
|
root `boards/` and `lib/`). ESP32-S3 / arduino-esp32 2.0.9:
|
|
**RAM 6.7%, Flash 5.5%**, binary at `firmware/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_FRICTION` constants 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)
|
|
|
|
1. `pio run -d examples/NetDeck -t upload` (or flash
|
|
`firmware/NetDeck_M1_261114.bin`).
|
|
2. Boot screen `M1 // SANDBOX` shows for 1.4 s, then the Cameras view.
|
|
3. `P` flips to Network view (dimmed ship + labeled graph), `Tab` too.
|
|
4. `Space` freezes (CRT scanlines, sim/packets halt); cursor stays live.
|
|
5. 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 terminal `T`.
|
|
- **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.
|
|
- **`X` severs 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
|
|
(`TEMP` bar). FRENZY/BLIND daemons are gated until a HIVE link is up
|
|
(effects land in M4).
|
|
- **`R` resets** 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 `r` reset; visual frame dumps inspected.
|