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).
60 lines
2.1 KiB
C++
60 lines
2.1 KiB
C++
/**
|
|
* Demo sketch — replace this file with your own experiment.
|
|
*
|
|
* This is the EMULATOR SHELL only. The actual demo lives in DemoCore.h
|
|
* (device-agnostic: RGB565 in panel wire order) so the same core can be
|
|
* driven by the firmware twin in fw/DemoHW.ino for hardware benchmarks.
|
|
*
|
|
* Contract with the emulator host (src/main.cpp):
|
|
* - implement setup() — called once at launch
|
|
* - implement loop() — called once per frame (host paces at ~60 fps)
|
|
* - the host provides emuGfx::fb565[] (320x240, RGB565 in panel wire
|
|
* order) — render into it, or hand your own buffer to the core
|
|
* - set emuGfx::dirty = true each frame you want presented
|
|
* - read keys from emu::keyboard (ASCII queue, filled from SDL events)
|
|
*
|
|
* Update state with DELTA TIME, not per-frame constants: measure the real
|
|
* seconds since the previous loop() call (see loop() below) and scale all
|
|
* speeds in "units per second" by it. Then the sketch runs at the same
|
|
* speed no matter what fps the host (or the real hardware) manages.
|
|
*
|
|
* This sample just bounces a colored box around — enough to prove the
|
|
* pipeline works. Delete everything and start from the structure below.
|
|
*/
|
|
|
|
#include "shim.h"
|
|
#include "DemoCore.h"
|
|
|
|
// Emulator state provided by the host (src/main.cpp)
|
|
extern uint16_t emuGfx::fb565[320 * 240];
|
|
extern bool emuGfx::dirty;
|
|
extern std::deque<uint8_t> emu::keyboard;
|
|
|
|
void setup()
|
|
{
|
|
demo::demoInit(emuGfx::fb565);
|
|
}
|
|
|
|
void loop()
|
|
{
|
|
// Keyboard pump
|
|
while (!emu::keyboard.empty()) {
|
|
uint8_t k = emu::keyboard.front();
|
|
emu::keyboard.pop_front();
|
|
demo::demoInput(k);
|
|
}
|
|
|
|
// Delta time: seconds since the previous frame.
|
|
static unsigned long lastMs = 0;
|
|
unsigned long now = millis();
|
|
float dt = lastMs ? (now - lastMs) / 1000.0f : 1.0f / 60.0f;
|
|
lastMs = now;
|
|
if (dt > 0.1f) dt = 0.1f; // clamp after stalls (drag, breakpoint)
|
|
|
|
// Render one frame into the 565 buffer
|
|
demo::demoFrame(dt, now);
|
|
|
|
// Present: the host expands 565 -> 8888 for the desktop window
|
|
emuGfx::dirty = true;
|
|
}
|