Files
Dejvino c58f31d02c emulator-template: RGB565 wire-order contract + ready-to-build HW twin
Propagate the lessons from tron-room-demo's hardware bring-up back into
the canonical template, so demos are hardware-testable from day one:

- Contract change: the sketch renders into emuGfx::fb565 (320x240
  uint16_t, RGB565 in PANEL WIRE ORDER - big-endian, the byte sequence
  the ST7789 receives over SPI, the same convention TFT_eSprite's
  primitives use). The host expands 565 to 8888 for SDL only. Native
  little-endian writes look right in the emulator but show byte-swapped
  on the panel (seen on hardware: BG 0x0002 -> green, fogged floor
  0x0882 -> pink) - the new contract makes that bug impossible.
- Recommended sketch structure: examples/APP/Core.h holds all
  rendering/logic device-agnostically (demoInit/demoInput/demoFrame);
  the .cpp is a thin emulator shell. Bundled sample demonstrates it.
- New fw/ scaffold: standalone PlatformIO project (shared boards/lib,
  T-Deck pin map) with DemoHW.ino driving the same core through a
  TFT_eSprite frameBuffer() and reporting true fps + render/push split
  over USB serial every 2 s. -O2 explicitly (pio default -Os skews
  benchmarks).
- shim.h gains rgb565()/wire565() helpers; Makefile deps now include
  the sketch's headers; --dump now also fires on safety-hatch exit (a
  long --frames run was silently losing its dump before).

Verified: template builds + smoke renders correct 565 colors; DemoHW
builds clean for ESP32-S3 (328 KB flash).
2026-11-16 22:51:44 +01:00

38 lines
1.2 KiB
INI

; PlatformIO project for running the template demo on the real T-Deck
; (ESP32-S3 + ST7789) as a free-running benchmark.
;
; Standalone on purpose (the repo's top-level platformio.ini keeps
; src_dir = src/netdeck for NetDeck): this points back at the shared
; boards/ and lib/ directories.
;
; pio run -d emulator-template/fw -t upload # flash the T-Deck
; pio device monitor # fps report every 2 s
;
; The loop free-runs (no pacing); the serial report's render/push split
; is the true throughput of the sketch core + SPI push on the hardware.
[platformio]
default_envs = DemoHW
src_dir = .
boards_dir = ../../boards
lib_dir = ../../lib
[env:DemoHW]
platform = espressif32@6.3.0
board = T-Deck
framework = arduino
upload_speed = 921600
monitor_speed = 115200
build_flags =
-DBOARD_HAS_PSRAM=1
-DCORE_DEBUG_LEVEL=1
-DARDUINO_USB_CDC_ON_BOOT=1
-DDISABLE_ALL_LIBRARY_WARNINGS
-DSPI_FREQUENCY=80000000
; -O2: PlatformIO's default -Os optimizes for size and can cost a
; large fraction of frame time — benchmarks deserve the honest number.
-O2
-I../examples/Demo
; T-Deck pin map (BOARD_POWERON, TFT pins...) from the firmware tree
-I../../src/netdeck