NetDeck M1: hardware sandbox — full-frame sprite rendering + firmware build
- render into a full-frame RAM second buffer (TFT_eSprite/PSRAM on device, SDL shim framebuffer in the emulator) and push to the ST7789 as one continuous SPI stream per frame (MiataDrive anti-tearing pattern) - keyboard stale-byte flush at boot end; device-trackball constants branch - examples/NetDeck/platformio.ini: self-contained firmware build (pio run -d examples/NetDeck), ESP32-S3 compile verified (RAM 6.7% / Flash 5.5%), binary at firmware/NetDeck_M1_261114.bin - STATUS.md: M1 tracker + on-device flashing checklist - IDEAS.md: capture map-scroll and companion-app ideas
This commit is contained in:
@@ -10,6 +10,12 @@
|
||||
|
||||
---
|
||||
|
||||
## 0. Design decisions
|
||||
|
||||
- T-Deck & Emulator are the primary targets. Plays nicely on T-Deck, but it isn't hard-dependent on it. There are multiple ways for the player to achieve their goal.
|
||||
|
||||
---
|
||||
|
||||
## 1. High Concept & Core Fantasy
|
||||
|
||||
You are not a soldier on the ground—you are the **Tactical Netrunner** strapped into a ruggedized portable cyberdeck in the breach airlock. Your 3-person marine fireteam is breaching derelict megacorp vessels overrun by rogue security droids and hostile ship-AI subsystems.
|
||||
|
||||
@@ -0,0 +1,7 @@
|
||||
# Map scrolling
|
||||
- move directly via trackball? by dragging touchscreen?
|
||||
- move by alt+trackball?
|
||||
- touch to click vs move / trackball to move cursor vs map
|
||||
|
||||
# Companion app
|
||||
- play on the T-Deck, have it connected over WiFi/BT to a computer/phone that shows a different view (bigger map, stats etc.)
|
||||
+29
-8
@@ -7,12 +7,12 @@ 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) |
|
||||
| **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 | 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)
|
||||
## M0 (done)
|
||||
|
||||
- `src/netdeck/nd_layout.h` — shared constants: 320x192 tactical view + HUD bar
|
||||
(one coordinate space), palette, fixed-timestep timings.
|
||||
@@ -28,10 +28,31 @@ milestone lands.
|
||||
- Emulator: `make APP=NetDeck run` / `smoke` from `emulator/`; host gained `Tab`
|
||||
key mapping (`emulator/src/main.cpp`).
|
||||
|
||||
## M1 remaining (hardware bring-up, same sketch)
|
||||
## M1 (this milestone)
|
||||
|
||||
- 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.
|
||||
- **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.
|
||||
|
||||
Reference in New Issue
Block a user