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).
38 lines
1.2 KiB
INI
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
|