Alexander Wennerstrøm
ab8b64d949
- Add complete board support for Waveshare ESP32-C6-Touch-AMOLED-2.16 with SH8601 display driver - Implement board initialization with AXP2101 PMU rail configuration for LCD and touch power - Add display driver for SH8601 QSPI panel (480×480 resolution) - Add CST9217 touch controller support via I2C - Add QMI8658 IMU initialization and sensor reading - Add AXP2101 power management and battery monitoring - Add input handling for BOOT button (GPIO 9) - Configure PlatformIO environment with C6-specific build flags and 16 MB flash layout - Update capability flags documentation to clarify BOARD_HAS_PSRAM build-flag macro usage - C6 has no external PSRAM; shared code gates on this flag to use internal SRAM and reduce LVGL buffer sizes - Screenshot capture disabled on this board due to internal SRAM constraints
2.8 KiB
Capability flags
Each board's board.h declares these. They're consumed in two places:
caps.cpp— copies them into theBoardCapsinstance so shared code (ui.cpp,main.cpp) can query them at runtime viaboard_caps().- The per-board source files —
#if BOARD_HAS_*lets the linker dead-strip entire functions on boards that don't need them.
Keep the two in sync. The pattern in caps.cpp does this for you:
.button_count = (uint8_t)(1 + BOARD_HAS_SECONDARY_BUTTON),
.has_rotation = (bool)BOARD_HAS_ROTATION,
The flags
| Macro | Default | What it gates |
|---|---|---|
BOARD_HAS_SECONDARY_BUTTON |
0 | A second physical button (HID Shift+Tab on the reference ports). caps.button_count = 1 + this. UI uses caps.button_count >= 2 to decide whether to poll/handle the secondary button — there is no #ifdef in shared code. |
BOARD_HAS_ROTATION |
0 | IMU-driven auto-rotation via CPU strip transformation in display_hal_draw_bitmap. When 0, display_hal_tick is a no-op and the rotation buffer in display.cpp doesn't get allocated. |
BOARD_HAS_IMU |
0 | Whether the accelerometer is populated and initialized. Distinct from BOARD_HAS_ROTATION — the AMOLED-1.8 has the QMI8658 (so HAS_IMU=1) but the kit's enclosure mounts the panel at a fixed orientation, so rotation is off. |
BOARD_HAS_BATTERY |
0 | Whether PMU battery measurement is meaningful on this board. UI hides the battery indicator when false. |
BOARD_HAS_IO_EXPANDER |
0 | Whether an IO expander gates display / touch reset lines. Doesn't directly gate any code path — but signals to the porter that board_init() must release the expander before display_hal_init(). |
Build-flag macros
BOARD_HAS_PSRAM is set as a -D build flag in platformio.ini (not in board.h) on chips with external PSRAM wired up. Shared code (main.cpp, splash.cpp) and per-board display drivers use it to choose between MALLOC_CAP_SPIRAM (large buffers) and MALLOC_CAP_INTERNAL (small buffers, partial-render LVGL, splash canvas capped at ~80 KB, screenshot capture disabled). New ESP32-C6 / ESP32-C3 ports must leave this undefined.
Future capabilities
Add a new flag when:
- A shared-code decision currently uses
if (caps.has_<thing>)and you want to extend it (e.g. addBOARD_HAS_HAPTICfor vibration feedback). - A per-board file conditionally compiles a block of code (e.g.
audio amp init under
BOARD_HAS_AUDIO).
Don't add a flag for a one-off detail. If only one board cares about it
and shared code never queries it, leave it as a constant in that board's
board.h and use it only in that board's .cpp files.