@geastack/targets 0.1.107 → 0.1.108

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/build-config.json +73 -0
  2. package/package.json +6 -6
  3. package/targets/esp32/chip_bindings/displays/sh8601.cpp +12 -2
  4. package/targets/esp32/chip_bindings/imu/qmi8658.cpp +10 -3
  5. package/targets/esp32/chip_bindings/power/axp2101.cpp +58 -0
  6. package/targets/esp32/chip_bindings/touch/cst9217.cpp +26 -23
  7. package/targets/esp32/connectivity/wifi.cpp +30 -2
  8. package/targets/esp32/gea_board_buttons.cmake +13 -0
  9. package/targets/esp32/gpio.cpp +124 -1
  10. package/targets/esp32/gpio_pins.h +17 -0
  11. package/targets/esp32/services/buttons.cpp +185 -0
  12. package/targets/esp32/services/buttons.h +46 -0
  13. package/targets/esp32/services/device_control.cpp +28 -0
  14. package/targets/esp32-s3-touch-amoled-1.75c/CMakeLists.txt +11 -0
  15. package/targets/esp32-s3-touch-amoled-1.75c/main/CMakeLists.txt +54 -0
  16. package/targets/esp32-s3-touch-amoled-1.75c/main/Kconfig.projbuild +12 -0
  17. package/targets/esp32-s3-touch-amoled-1.75c/main/gea-dependencies.json +42 -0
  18. package/targets/esp32-s3-touch-amoled-1.75c/main/idf_component.yml +10 -0
  19. package/targets/esp32-s3-touch-amoled-1.75c/main/include/board.h +113 -0
  20. package/targets/esp32-s3-touch-amoled-1.75c/partitions.csv +9 -0
  21. package/targets/esp32-s3-touch-amoled-1.75c/sdkconfig.defaults +279 -0
  22. package/targets/esp32-s3-touch-amoled-1.8/main/CMakeLists.txt +10 -1
  23. package/targets/esp32-s3-touch-amoled-1.8/main/app_main.cpp +2 -0
  24. package/targets/esp32-s3-touch-amoled-2.06/main/CMakeLists.txt +13 -0
  25. package/targets/esp32-s3-touch-amoled-2.06/main/app_main.cpp +2 -0
  26. package/targets/esp32-s3-touch-amoled-2.06/sdkconfig.defaults +5 -3
  27. package/targets/esp32-s3-touch-lcd-3.49/CMakeLists.txt +11 -0
  28. package/targets/esp32-s3-touch-lcd-3.49/main/CMakeLists.txt +82 -0
  29. package/targets/esp32-s3-touch-lcd-3.49/main/Kconfig.projbuild +12 -0
  30. package/targets/esp32-s3-touch-lcd-3.49/main/gea-dependencies.json +42 -0
  31. package/targets/esp32-s3-touch-lcd-3.49/main/idf_component.yml +8 -0
  32. package/targets/esp32-s3-touch-lcd-3.49/main/include/axs15231b_panel_init.h +9 -0
  33. package/targets/esp32-s3-touch-lcd-3.49/main/include/board.h +160 -0
  34. package/targets/esp32-s3-touch-lcd-3.49/main/panel_reset.cpp +93 -0
  35. package/targets/esp32-s3-touch-lcd-3.49/main/power.cpp +60 -0
  36. package/targets/esp32-s3-touch-lcd-3.49/main/touch.cpp +327 -0
  37. package/targets/esp32-s3-touch-lcd-3.49/partitions.csv +7 -0
  38. package/targets/esp32-s3-touch-lcd-3.49/sdkconfig.defaults +279 -0
  39. package/targets.json +60 -1
@@ -0,0 +1,279 @@
1
+ # Target: ESP32-S3
2
+ CONFIG_IDF_TARGET="esp32s3"
3
+
4
+ # Flash: 32 MB (Waveshare ESP32-S3-Touch-AMOLED-1.75C)
5
+ CONFIG_ESPTOOLPY_FLASHSIZE_32MB=y
6
+
7
+ # Allow bootloader cache-mapped reads from 32-bit SPI flash addresses. This is
8
+ # required for bootable app partitions above 16 MB on the board's DIO flash.
9
+ CONFIG_IDF_EXPERIMENTAL_FEATURES=y
10
+ CONFIG_BOOTLOADER_CACHE_32BIT_ADDR_QUAD_FLASH=y
11
+
12
+ # Console over USB Serial/JTAG (native USB-C on this board)
13
+ CONFIG_ESP_CONSOLE_USB_SERIAL_JTAG=y
14
+
15
+ # esp_codec_dev should share the existing new-driver I2C bus with touch/PMIC.
16
+ # CONFIG_CODEC_I2C_BACKWARD_COMPATIBLE is not set
17
+
18
+ # Disable secondary console to avoid duplicate output
19
+ CONFIG_ESP_CONSOLE_SECONDARY_NONE=y
20
+
21
+ # FreeRTOS tick rate — 1000 Hz gives 1 ms resolution for modMilliseconds
22
+ CONFIG_FREERTOS_HZ=1000
23
+
24
+ # Run the S3 at its full rated app CPU clock. Bouncing display workloads are
25
+ # otherwise CPU-bound before the 80 MHz QSPI flush finishes.
26
+ CONFIG_ESP_DEFAULT_CPU_FREQ_MHZ_240=y
27
+ CONFIG_ESP_DEFAULT_CPU_FREQ_MHZ=240
28
+
29
+ # Main task stack for the app event loop. gea TSX frames can build deep
30
+ # reactive call chains before returning to the firmware loop.
31
+ CONFIG_ESP_MAIN_TASK_STACK_SIZE=32768
32
+ # The IPC task is per-core and its stack is internal DRAM, so 16384 cost 32 KiB of
33
+ # the scarcest memory on this board for tasks that only ever run ESP-IDF's own
34
+ # cross-core callbacks (intr_alloc is the single caller of esp_ipc_call_blocking
35
+ # in this firmware). IDF's default is 1024; 4096 keeps a 4x margin and hands ~24
36
+ # KiB back to the DMA-capable heap that the display staging and the WiFi RX
37
+ # frames were fighting over.
38
+ CONFIG_ESP_IPC_TASK_STACK_SIZE=4096
39
+
40
+ # Wi-Fi scan/connect callbacks run on ESP-IDF's system event task.
41
+ CONFIG_ESP_SYSTEM_EVENT_TASK_STACK_SIZE=4096
42
+
43
+ # Custom partition table with two OTA slots for wireless updates
44
+ CONFIG_PARTITION_TABLE_CUSTOM=y
45
+ CONFIG_PARTITION_TABLE_CUSTOM_FILENAME="partitions.csv"
46
+
47
+ # On panic: print backtrace then reboot. (Halting was meant to "keep USB alive
48
+ # for reflashing", but a halted ESP32-S3 won't accept an esptool reset — it has
49
+ # to be recovered over JTAG. Rebooting allows the firmware to remain
50
+ # reachable for diagnosis and reflashing.)
51
+ CONFIG_ESP_SYSTEM_PANIC_PRINT_REBOOT=y
52
+
53
+ # Enable octal PSRAM for framebuffer
54
+ CONFIG_SPIRAM=y
55
+ CONFIG_SPIRAM_MODE_OCT=y
56
+ CONFIG_SPIRAM_SPEED_80M=y
57
+ CONFIG_SPIRAM_ALLOW_BSS_SEG_EXTERNAL_MEMORY=y
58
+ CONFIG_FREERTOS_TASK_CREATE_ALLOW_EXT_MEM=y
59
+ # vTaskDeleteWithCaps(NULL) (fetchAsync job tasks end this way) deletes the task from a helper task with
60
+ # configMINIMAL_STACK_SIZE, which follows this; the default 1536 overflows while the job's thread-local
61
+ # state is torn down and reboots the board.
62
+ CONFIG_FREERTOS_IDLE_TASK_STACKSIZE=3072
63
+ CONFIG_SPIRAM_TRY_ALLOCATE_WIFI_LWIP=y
64
+ CONFIG_SPIRAM_MALLOC_ALWAYSINTERNAL=0
65
+ # IDF defaults this to 32 KiB when SPIRAM malloc is enabled. That creates a
66
+ # second DMA/internal heap by allocating a chunk from internal DRAM and
67
+ # re-registering it, which splits the physical heap map into a middle green
68
+ # reserve island. Keep internal memory globally allocatable; app/display code
69
+ # already asks for MALLOC_CAP_INTERNAL/MALLOC_CAP_DMA when it truly needs it.
70
+ CONFIG_SPIRAM_MALLOC_RESERVE_INTERNAL=0
71
+
72
+ # Wi-Fi/LwIP memory budget: prefer lower throughput over internal DRAM pressure.
73
+ CONFIG_ESP_WIFI_STATIC_RX_BUFFER_NUM=8
74
+ CONFIG_ESP_WIFI_DYNAMIC_RX_BUFFER_NUM=16
75
+ CONFIG_ESP_WIFI_STATIC_TX_BUFFER_NUM=4
76
+ CONFIG_ESP_WIFI_CACHE_TX_BUFFER_NUM=2
77
+ CONFIG_ESP_WIFI_MGMT_SBUF_NUM=16
78
+ CONFIG_ESP_WIFI_RX_BA_WIN=8
79
+ # RX-MGMT buffers DYNAMIC, not static. A RAM-tight app (maps: full-screen canvas
80
+ # + tile cache) leaves esp_wifi_init only ~11 KB internal DMA, but its STATIC
81
+ # esf_buf pool (static_rx 3 + rx_mgmt 5 + cache_tx 2 = 10 DMA-capable internal
82
+ # buffers) overflows it → esf_buf_setup_static NO_MEM → WiFi never comes up (no
83
+ # map tiles). Dynamic mgmt buffers leave the static pool and, with
84
+ # CONFIG_SPIRAM_TRY_ALLOCATE_WIFI_LWIP=y above, allocate on demand from PSRAM.
85
+ # MUST be set here, not via the runtime wifi_init_config: flipping rx_mgmt_buf_type
86
+ # at runtime against a static-configured build asserts inside esp_wifi_init
87
+ # (panic/reboot loop). Doing it in sdkconfig keeps WIFI_INIT_CONFIG_DEFAULT consistent.
88
+ # CONFIG_ESP_WIFI_STATIC_RX_MGMT_BUFFER is not set
89
+ CONFIG_ESP_WIFI_DYNAMIC_RX_MGMT_BUFFER=y
90
+ # CONFIG_ESP_WIFI_IRAM_OPT is not set
91
+ # Measured on this board, NOT worth it for OTA. Putting the WiFi RX path in IRAM
92
+ # does what it promises — the receive phase of a 3.8 MB image went from 277 KB/s
93
+ # to 488 KB/s, because RX keeps running through the cache-disabled windows that
94
+ # esp_ota_write opens. But the same live RX path then contends with the flash
95
+ # operation it is running alongside, and the write phase fell from 502 KB/s to
96
+ # 213 KB/s. End to end that is 116 KB/s against 133 KB/s, plus ~10 KB of internal
97
+ # DRAM. Left off deliberately; do not re-enable without re-measuring both phases.
98
+ # CONFIG_ESP_WIFI_RX_IRAM_OPT is not set
99
+ # Wi-Fi driver task: IDF 5.5/6.0 no longer exposes a public
100
+ # CONFIG_ESP_WIFI_TASK_STACK_SIZE knob. targets/esp32/connectivity/wifi.cpp
101
+ # wraps wifi_init_config_t.osi_funcs task creation and bumps the closed-source
102
+ # "wifi" task to 8192 bytes there.
103
+ CONFIG_LWIP_TCPIP_TASK_STACK_SIZE=4096
104
+
105
+ # Allow lwIP to buffer out-of-sequence TCP segments. Without them a single dropped
106
+ # segment forces go-back-N retransmission of everything in flight, which (with RTO
107
+ # backoff 1.5+3+6+...s) turns one packet loss into a ~15s stall on an otherwise-fast
108
+ # link. 0 means UNCAPPED here, which is also IDF's own default whenever
109
+ # CONFIG_SPIRAM_TRY_ALLOCATE_WIFI_LWIP is set, because the pbufs then come from
110
+ # PSRAM and are only held while a gap actually exists. The previous cap of 8 was
111
+ # below the widened receive window, so a loss early in a 16-segment window could
112
+ # not be bridged: an OTA transfer was bimodal, either ~17 s or ~87 s for the same
113
+ # 3.9 MB image under identical conditions, with the slow mode sitting in RTO backoff.
114
+ CONFIG_LWIP_TCP_OOSEQ_MAX_PBUFS=0
115
+
116
+ # Advertise selective acknowledgements. An OTA receiver drops frames every time
117
+ # esp_ota_write disables the flash cache, and without SACK the sender cannot tell
118
+ # which single segment went missing — it retransmits the whole window and backs
119
+ # off. This is the other half of the bimodal-throughput fix above.
120
+ CONFIG_LWIP_TCP_SACK_OUT=y
121
+
122
+ # TCP receive window. The IDF default of 5760 is four segments: an OTA image
123
+ # arrives through a receiver that has to stop and write to flash, and with a
124
+ # four-segment window the sender spends most of the transfer blocked waiting for
125
+ # a window update instead of keeping the link busy. Sixteen segments give the
126
+ # flash writes something to overlap with. The buffering behind the window is
127
+ # lwIP pbufs and WiFi dynamic RX frames, both of which prefer PSRAM here
128
+ # (CONFIG_SPIRAM_TRY_ALLOCATE_WIFI_LWIP above), so this does not spend internal
129
+ # DRAM. 23040 stays under 65535, so no window scaling is required.
130
+ CONFIG_LWIP_TCP_WND_DEFAULT=23040
131
+ CONFIG_LWIP_TCP_RECVMBOX_SIZE=16
132
+
133
+ # Firmware uses STA mode for OTA/log/mirror; trim unused Wi-Fi/LwIP features.
134
+ CONFIG_ESP_WIFI_SOFTAP_SUPPORT=y
135
+ # CONFIG_ESP_WIFI_ENTERPRISE_SUPPORT is not set
136
+ # CONFIG_ESP_WIFI_ENABLE_WPA3_SAE is not set
137
+ # CONFIG_ESP_WIFI_ENABLE_WPA3_OWE_STA is not set
138
+ # esp_peer (WebRTC transport) needs IPv6 sockets.
139
+ CONFIG_LWIP_IPV6=y
140
+ # WiFi provisioning runs a captive-portal SoftAP with its own DHCP server.
141
+ CONFIG_LWIP_DHCPS=y
142
+
143
+ # Bluetooth: NimBLE dual-role for the BLE control surface. This board serves
144
+ # HID + BLE-MIDI as a peripheral AND hosts remote peripherals as a central
145
+ # (XPPen ACK05 macro pad, WIDI/pedal BLE-MIDI adapter) — 4 simultaneous links:
146
+ # desktop (our HID), DAW (our MIDI), XPPen, pedal.
147
+ CONFIG_BT_ENABLED=y
148
+ CONFIG_BT_NIMBLE_ENABLED=y
149
+ CONFIG_BT_NIMBLE_MEM_ALLOC_MODE_EXTERNAL=y
150
+ CONFIG_BT_NIMBLE_MAX_CONNECTIONS=4
151
+ CONFIG_BT_NIMBLE_ROLE_BROADCASTER=y
152
+ CONFIG_BT_NIMBLE_ROLE_PERIPHERAL=y
153
+ CONFIG_BT_NIMBLE_ROLE_CENTRAL=y
154
+ CONFIG_BT_NIMBLE_ROLE_OBSERVER=y
155
+ CONFIG_BT_NIMBLE_SM_LEGACY=y
156
+ CONFIG_BT_NIMBLE_SM_SC=y
157
+ CONFIG_BT_NIMBLE_NVS_PERSIST=y
158
+ CONFIG_BT_NIMBLE_LOG_LEVEL_NONE=y
159
+
160
+ # Pin WiFi + BT controller + NimBLE host to core 1, leaving core 0 for the app
161
+ # frame/render task (GEA_EMBEDDED_APP_FRAME_TASK_CORE=0). IDF pins all of these
162
+ # to core 0 by default, where they contend with rendering: launching an app
163
+ # through the launcher dropped to ~22 fps because the per-chunk flush wait was
164
+ # preempted (19 ms vs 1.6 ms). Moving them to core 1 restores ~60 fps. Keep
165
+ # WiFi and BT on the SAME core for coexistence (ESP_COEX_SW_COEXIST_ENABLE).
166
+ CONFIG_ESP_WIFI_TASK_PINNED_TO_CORE_1=y
167
+ CONFIG_BT_CTRL_PINNED_TO_CORE_1=y
168
+ CONFIG_BT_NIMBLE_PINNED_TO_CORE_1=y
169
+
170
+ # WebRTC: mbedTLS DTLS + DTLS-SRTP for esp_peer
171
+ # Required by espressif/esp_peer (DTLS-SRTP handshake, DTLS cookies, MTU
172
+ # config). Off by default in IDF — turning them on costs ~30-40 kB of
173
+ # mbedTLS code but is non-negotiable for SRTP-protected RTP.
174
+ CONFIG_MBEDTLS_SSL_PROTO_DTLS=y
175
+ CONFIG_MBEDTLS_SSL_DTLS_SRTP=y
176
+ CONFIG_MBEDTLS_SSL_DTLS_HELLO_VERIFY=y
177
+ CONFIG_MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE=y
178
+ CONFIG_MBEDTLS_SSL_DTLS_CONNECTION_ID=y
179
+ # esp_peer generates a self-signed DTLS cert at runtime via
180
+ # mbedtls_x509write_crt_*; those live behind MBEDTLS_X509_CREATE_C, which
181
+ # ESP-IDF 6.0 flipped to default-off (was implicitly available in 5.5). Without
182
+ # it esp_peer fails to link (implicit-declaration of mbedtls_x509write_crt_*).
183
+ CONFIG_MBEDTLS_X509_CREATE_C=y
184
+ CONFIG_MBEDTLS_X509_CRT_WRITE_C=y
185
+ CONFIG_MBEDTLS_X509_CSR_WRITE_C=y
186
+
187
+ # Allocate mbedTLS memory from PSRAM instead of internal DRAM. IDF defaults to
188
+ # INTERNAL_MEM_ALLOC, but internal RAM is scarce on this board (app + 2-deep
189
+ # flush pipeline + WiFi driver). A TLS handshake's PSA signature verification
190
+ # and 16 KB input buffer then fail to allocate, surfacing as the misleading
191
+ # "esp-x509-crt-bundle: Certificate matched but signature verification failed"
192
+ # with PSA error -141 (PSA_ERROR_INSUFFICIENT_MEMORY) — a heap shortage, not a
193
+ # trust failure. PSRAM has megabytes free; the hardware MPI/crypto path copies
194
+ # operands into the peripheral so PSRAM-resident TLS buffers are fine.
195
+ # CONFIG_MBEDTLS_INTERNAL_MEM_ALLOC is not set
196
+ CONFIG_MBEDTLS_EXTERNAL_MEM_ALLOC=y
197
+
198
+ # Run TLS crypto in SOFTWARE so it allocates from PSRAM (via EXTERNAL_MEM_ALLOC
199
+ # above) rather than DMA-capable internal SRAM. EXTERNAL_MEM_ALLOC moves the
200
+ # mbedTLS input/output buffers to PSRAM, but the ESP32-S3 SHA/MPI/AES hardware
201
+ # drivers bypass the mbedTLS allocator and demand MALLOC_CAP_DMA|MALLOC_CAP_INTERNAL
202
+ # scratch buffers (e.g. sha.c allocates a DMA buffer sized to the data being
203
+ # hashed). Once WiFi is up, internal 8-bit RAM is ~1 KB free, so those allocations
204
+ # fail mid-handshake — surfacing as mbedtls_ssl_setup -> MBEDTLS_ERR_SSL_ALLOC_FAILED
205
+ # (PSA -141) and ESP_ERR_HTTP_CONNECT on every HTTPS fetch. Software crypto keeps
206
+ # everything in PSRAM and is amply fast for the app's occasional small fetches.
207
+ # CONFIG_MBEDTLS_HARDWARE_SHA is not set
208
+ # CONFIG_MBEDTLS_HARDWARE_MPI is not set
209
+ # CONFIG_MBEDTLS_MPI_USE_INTERRUPT is not set
210
+ # CONFIG_MBEDTLS_HARDWARE_AES is not set
211
+
212
+ # Release optimization level. ESP-IDF defaults to -Og (DEBUG) which is
213
+ # friendly for debugging but leaves real perf on the table for compute-heavy
214
+ # code paths. -O2 (PERF) is the correct release setting.
215
+ CONFIG_COMPILER_OPTIMIZATION_PERF=y
216
+ # CONFIG_COMPILER_OPTIMIZATION_DEBUG is not set
217
+
218
+ # --- Development logging / diagnostics defaults ---
219
+ # VS Code launch tasks build per-app firmware under build/app-builds/<app>.
220
+ # Keep those dev builds chatty by default so serial monitor shows boot logs,
221
+ # gea.perf fps windows, frame scheduler diagnostics, and assertion failures.
222
+ # Production lockdown can still be enabled via menuconfig, but it is not the
223
+ # default for local flash/monitor iteration.
224
+ # CONFIG_GEA_EMBEDDED_PRODUCTION_LOCKDOWN is not set
225
+
226
+ # Runtime and bootloader logs visible on USB serial/JTAG.
227
+ # CONFIG_LOG_DEFAULT_LEVEL_NONE is not set
228
+ CONFIG_LOG_DEFAULT_LEVEL_INFO=y
229
+ CONFIG_LOG_DEFAULT_LEVEL=3
230
+ CONFIG_LOG_MAXIMUM_EQUALS_DEFAULT=y
231
+ CONFIG_LOG_MAXIMUM_LEVEL=3
232
+
233
+ # Keep assertions enabled in local dev builds.
234
+ # CONFIG_COMPILER_OPTIMIZATION_ASSERTIONS_DISABLE is not set
235
+ CONFIG_COMPILER_OPTIMIZATION_ASSERTIONS_ENABLE=y
236
+ CONFIG_COMPILER_OPTIMIZATION_ASSERTION_LEVEL=2
237
+ # geatsc lowers a program's `throw`/`try`/`catch` to real C++ exceptions, and
238
+ # its runtime header (`gea_runtime.h`, e.g. the regex cache's std::regex_error
239
+ # translation) contains typed catch handlers unconditionally. ESP-IDF's default
240
+ # stubs __cxa_throw to abort and compiles with -fno-exceptions, under which
241
+ # gcc rejects those handlers -- so no geatsc-generated app compiles for this
242
+ # board without exception support. The emergency pool stays 0: the cost is
243
+ # unwind tables in flash and ~500 B of heap on the first throw, nothing at rest.
244
+ CONFIG_COMPILER_CXX_EXCEPTIONS=y
245
+ CONFIG_COMPILER_CXX_EXCEPTIONS_EMG_POOL_SIZE=0
246
+
247
+ # Keep early boot output visible too.
248
+ # CONFIG_BOOTLOADER_LOG_LEVEL_NONE is not set
249
+ CONFIG_BOOTLOADER_LOG_LEVEL_INFO=y
250
+ CONFIG_BOOTLOADER_LOG_LEVEL=3
251
+
252
+ # Diagnostic allocation attribution. Keep standalone heap tracing available for
253
+ # app-init fragmentation investigations; trace records are placed in PSRAM by
254
+ # the caller, and tracing remains idle unless explicitly started.
255
+ # Heap tracing costs about a kilobyte of IRAM (1,067 bytes measured on
256
+ # esp32-s3-touch-amoled-2.06) and puts a hook on the allocator's hot path. On the
257
+ # S3 that IRAM is not free space: the linker sizes .dram0.dummy to whatever IRAM
258
+ # the image used, so every byte of .iram0.text is a byte the internal heap never
259
+ # gets -- and the internal heap is what DMA, USB host enumeration and aligned
260
+ # coefficient banks come out of. The framework's only users, the display and
261
+ # AXP2101 init traces, are already gated on GEA_EMBEDDED_HEAP_DIAGNOSTICS_LOG,
262
+ # which defaults to 0. So nothing traced by default and every app paid for it.
263
+ # Turn this and that macro on together when you actually want a trace.
264
+ CONFIG_HEAP_TRACING_OFF=y
265
+ # CONFIG_HEAP_TRACING_STANDALONE is not set
266
+ # CONFIG_HEAP_TRACING_TOHOST is not set
267
+ # CONFIG_HEAP_TRACING is not set
268
+ # CONFIG_HEAP_TRACE_HASH_MAP is not set
269
+
270
+ # Instruction cache: the default 16 KB / 32-byte-line I-cache thrashes on
271
+ # frame loops that touch libm. Measured on bubble-grid: a Math.pow costs
272
+ # 25.4k cycles cold but 6.5k warm back-to-back, and Date.now 11.5k vs 4.1k --
273
+ # i.e. ~19k and ~7.4k cycles per frame are pure cold-flash refetch, because
274
+ # the rest of the frame evicts the routine before the next frame calls it.
275
+ # 32 KB holds more of the frame's working set. (S3's I-cache line size is
276
+ # 16B or 32B only -- there is no 64B option.) the gea CLI also enforces this
277
+ # on every build, because the generated sdkconfig is sticky and defaults only
278
+ # fill values that an existing build directory has not already frozen.
279
+ CONFIG_ESP32S3_INSTRUCTION_CACHE_32KB=y
@@ -83,6 +83,9 @@ endif()
83
83
  if(NOT DEFINED GEA_BOARD_FRAMEBUFFER_STREAM_FLUSH)
84
84
  set(GEA_BOARD_FRAMEBUFFER_STREAM_FLUSH 1)
85
85
  endif()
86
+ if(NOT DEFINED GEA_BOARD_FRAME_SCHEDULER_DROP_CATCHUP_FRAMES)
87
+ set(GEA_BOARD_FRAME_SCHEDULER_DROP_CATCHUP_FRAMES 0)
88
+ endif()
86
89
  if(NOT DEFINED GEA_BOARD_PARTIAL_PAD_X)
87
90
  set(GEA_BOARD_PARTIAL_PAD_X 8)
88
91
  endif()
@@ -487,6 +490,7 @@ idf_component_register(
487
490
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/app_runner.cpp"
488
491
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/app_state.cpp"
489
492
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/battery_service.cpp"
493
+ "${GEA_EMBEDDED_ROOT}/targets/esp32/services/buttons.cpp"
490
494
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/device_control.cpp"
491
495
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/frame_scheduler.cpp"
492
496
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/memory.cpp"
@@ -562,6 +566,9 @@ endforeach()
562
566
 
563
567
  target_compile_definitions(${COMPONENT_LIB} PRIVATE
564
568
  ${_GEA_BOARD_DISPLAY_DEFINITIONS}
569
+ # GEA_EMBEDDED_CPP_BOARD is a bare flag build-wide (gea_framework.cmake); app
570
+ # native code that wants the board name reads this string instead.
571
+ GEA_EMBEDDED_BOARD_ID="${GEA_EMBEDDED_CPP_BOARD}"
565
572
  GEA_EMBEDDED_FLUSH_ANCHOR_LEFT_PARTIAL_RECTS=0
566
573
  GEA_EMBEDDED_PIXEL_PANEL_ENDIAN=1
567
574
  GEA_CPP_ENABLE_REGEX=0
@@ -601,7 +608,7 @@ target_compile_definitions(${COMPONENT_LIB} PRIVATE
601
608
  # Was =1 from an old display-pacing experiment (f06ad9724) that disabled the
602
609
  # then-broken queueFrameEvent catch-up. =0 re-enables catch-up, now driven by
603
610
  # the work-based, event-loop graceful-overrun path (frame_scheduler/runtime).
604
- GEA_EMBEDDED_FRAME_SCHEDULER_DROP_CATCHUP_FRAMES=0
611
+ GEA_EMBEDDED_FRAME_SCHEDULER_DROP_CATCHUP_FRAMES=${GEA_BOARD_FRAME_SCHEDULER_DROP_CATCHUP_FRAMES}
605
612
  GEA_EMBEDDED_APP_FRAME_TASK_PRIORITY=23
606
613
  # 2-core replay split: the defaults (96 rows / 64k px) almost never fire on
607
614
  # this 368x448 panel (165k px full screen), so animated-transform scenes
@@ -745,3 +752,5 @@ gea_framework_inherit_build_settings()
745
752
  # This target has a dedicated storage partition, as on the 2.06 AMOLED.
746
753
  # Mount it for localStorage and the existing USB file-transfer diagnostics.
747
754
  target_compile_definitions(${COMPONENT_LIB} PRIVATE GEA_STORAGE_SPIFFS=1)
755
+ include("${GEA_EMBEDDED_ROOT}/targets/esp32/gea_board_buttons.cmake")
756
+ gea_board_buttons(${COMPONENT_LIB})
@@ -17,6 +17,7 @@ void registerDriver();
17
17
  }
18
18
  #include "memory_config.h"
19
19
  #include "runtime.h"
20
+ #include "services/buttons.h"
20
21
  #include "services/device_control.h"
21
22
 
22
23
  #include <cstdlib>
@@ -200,6 +201,7 @@ extern "C" void app_main(void)
200
201
  logHeapProbe("app_main:before_device_control_task");
201
202
  #endif
202
203
  gea::platform::esp32::services::startDeviceControlTask();
204
+ gea::platform::esp32::buttons::start();
203
205
  #if GEA_EMBEDDED_HEAP_DIAGNOSTICS_LOG
204
206
  logHeapProbe("app_main:before_runtime");
205
207
  #endif
@@ -535,6 +535,7 @@ if(NOT GEA_APP_CANVAS_ONLY)
535
535
  list(APPEND GEA_EMBEDDED_TARGET_SERVICE_SOURCES
536
536
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/app_runner.cpp"
537
537
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/battery_service.cpp"
538
+ "${GEA_EMBEDDED_ROOT}/targets/esp32/services/buttons.cpp"
538
539
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/device_control.cpp"
539
540
  "${GEA_EMBEDDED_ROOT}/targets/esp32/services/storage_service.cpp"
540
541
  )
@@ -667,6 +668,11 @@ target_compile_options(${COMPONENT_LIB} PRIVATE -iquote "${GENERATED_APP_DIR}")
667
668
  # to the `storage` SPIFFS partition on the 32MB flash instead of the tiny, full
668
669
  # NVS blob. See targets/esp32/services/storage_service.cpp and partitions.csv.
669
670
  target_compile_definitions(${COMPONENT_LIB} PRIVATE GEA_STORAGE_SPIFFS=1)
671
+ # The canvas-only runtime links no button service.
672
+ if(NOT GEA_APP_CANVAS_ONLY)
673
+ include("${GEA_EMBEDDED_ROOT}/targets/esp32/gea_board_buttons.cmake")
674
+ gea_board_buttons(${COMPONENT_LIB})
675
+ endif()
670
676
 
671
677
  set(GEA_EMBEDDED_HEAP_DIAGNOSTICS_LOG_VALUE 0)
672
678
  if(DEFINED ENV{GEA_EMBEDDED_HEAP_DIAGNOSTICS_LOG})
@@ -683,6 +689,13 @@ endif()
683
689
 
684
690
  target_compile_definitions(${COMPONENT_LIB} PRIVATE
685
691
  ${GEA_CUSTOM_TARGET_COMPILE_DEFINITIONS}
692
+ # App native code reads the board name from this string.
693
+ GEA_EMBEDDED_BOARD_ID="${GEA_EMBEDDED_CPP_BOARD}"
694
+ # Run the runtime on a PSRAM-stacked task and let app_main return, which
695
+ # hands the 32 KB internal main stack back to the heap: with WiFi and BLE
696
+ # up, the audio task's 8 KB internal stack does not fit otherwise.
697
+ GEA_EMBEDDED_RUNTIME_TASK_STACK_BYTES=32768
698
+ GEA_EMBEDDED_RUNTIME_TASK_STACK_EXTERNAL=1
686
699
  ${GEA_EMBEDDED_PIXEL_PANEL_ENDIAN_DEFINE}
687
700
  GEA_CPP_ENABLE_REGEX=0
688
701
  GEA_CPP_USE_TO_CHARS_DOUBLE=0
@@ -31,6 +31,7 @@ void registerDriver();
31
31
  #include "memory_config.h"
32
32
  #include "runtime.h"
33
33
  #if GEA_EMBEDDED_FULL_BOOT_SERVICES
34
+ #include "services/buttons.h"
34
35
  #include "services/device_control.h"
35
36
  #endif
36
37
 
@@ -269,6 +270,7 @@ extern "C" void app_main(void)
269
270
  #endif
270
271
  #if GEA_EMBEDDED_FULL_BOOT_SERVICES
271
272
  gea::platform::esp32::services::startDeviceControlTask();
273
+ gea::platform::esp32::buttons::start();
272
274
  #endif
273
275
  #if GEA_EMBEDDED_HEAP_DIAGNOSTICS_LOG
274
276
  logHeapProbe("app_main:before_runtime");
@@ -131,12 +131,14 @@ CONFIG_LWIP_TCP_WND_DEFAULT=23040
131
131
  CONFIG_LWIP_TCP_RECVMBOX_SIZE=16
132
132
 
133
133
  # Firmware uses STA mode for OTA/log/mirror; trim unused Wi-Fi/LwIP features.
134
- # CONFIG_ESP_WIFI_SOFTAP_SUPPORT is not set
134
+ CONFIG_ESP_WIFI_SOFTAP_SUPPORT=y
135
135
  # CONFIG_ESP_WIFI_ENTERPRISE_SUPPORT is not set
136
136
  # CONFIG_ESP_WIFI_ENABLE_WPA3_SAE is not set
137
137
  # CONFIG_ESP_WIFI_ENABLE_WPA3_OWE_STA is not set
138
- # CONFIG_LWIP_IPV6 is not set
139
- # CONFIG_LWIP_DHCPS is not set
138
+ # esp_peer (WebRTC transport) needs IPv6 sockets.
139
+ CONFIG_LWIP_IPV6=y
140
+ # WiFi provisioning runs a captive-portal SoftAP with its own DHCP server.
141
+ CONFIG_LWIP_DHCPS=y
140
142
 
141
143
  # Bluetooth: NimBLE dual-role for the BLE control surface. This board serves
142
144
  # HID + BLE-MIDI as a peripheral AND hosts remote peripherals as a central
@@ -0,0 +1,11 @@
1
+ cmake_minimum_required(VERSION 3.16)
2
+
3
+ set(EXTRA_COMPONENT_DIRS "${CMAKE_CURRENT_LIST_DIR}/../esp32/components")
4
+ include("${CMAKE_CURRENT_LIST_DIR}/../esp32/app_project.cmake")
5
+ set(GEA_EMBEDDED_APP "tic-tac-toe" CACHE STRING "Example app to build (must match a package.json gea.id)")
6
+ set(PROJECT_VER "${GEA_EMBEDDED_APP}" CACHE STRING "Firmware app id" FORCE)
7
+
8
+ include($ENV{IDF_PATH}/tools/cmake/project.cmake)
9
+ idf_build_set_property(MINIMAL_BUILD ON)
10
+ gea_solve_dependencies_in_build_dir()
11
+ project(gea_embedded)
@@ -0,0 +1,82 @@
1
+ set(GEA_BOARD_COMPONENT_DIR "${CMAKE_CURRENT_LIST_DIR}")
2
+ set(GEA_BOARD_TARGET_DIR "${CMAKE_CURRENT_LIST_DIR}/..")
3
+ set(GEA_EMBEDDED_CPP_BOARD "esp32-s3-touch-lcd-3.49")
4
+ set(GEA_EMBEDDED_ROOT "${CMAKE_CURRENT_LIST_DIR}/../../..")
5
+ cmake_path(ABSOLUTE_PATH GEA_EMBEDDED_ROOT NORMALIZE)
6
+ include("${GEA_EMBEDDED_ROOT}/targets/esp32/gea_framework.cmake")
7
+ set(GEA_EMBEDDED_CSS_DEVICE_PIXEL_RATIO "1.0" CACHE STRING "Logical CSS pixel scale")
8
+
9
+ # 172x640 glass, landscape by default. Like the T-Display-S3 Long's 180x640
10
+ # AXS15231B, the controller has no usable hardware XY swap, so the runtime
11
+ # rotates in software and every transfer spans the native 172-pixel scanline.
12
+ set(GEA_BOARD_DISPLAY_WIDTH 640)
13
+ set(GEA_BOARD_DISPLAY_HEIGHT 172)
14
+ set(GEA_BOARD_NATIVE_DISPLAY_WIDTH 172)
15
+ set(GEA_BOARD_NATIVE_DISPLAY_HEIGHT 640)
16
+ # The vendor drives this panel at 40 MHz; so does the 3.5B's AXS15231B.
17
+ set(GEA_BOARD_QSPI_PCLK_HZ 40000000)
18
+ set(GEA_BOARD_FRAMEBUFFER_STREAM_FLUSH 1)
19
+ # Paired with the 30 fps interval below: drop catch-up frames so the cap holds.
20
+ set(GEA_BOARD_FRAME_SCHEDULER_DROP_CATCHUP_FRAMES 1)
21
+ set(GEA_BOARD_PARTIAL_PAD_X 0)
22
+ set(GEA_BOARD_PARTIAL_PAD_Y 0)
23
+ set(GEA_BOARD_STREAM_PACE_CHUNKS 0)
24
+ set(GEA_BOARD_EXTRA_REQUIRES esp_driver_ledc esp_codec_dev esp_adc)
25
+ set(GEA_BOARD_EXTRA_COMPILE_DEFINITIONS
26
+ GEA_EMBEDDED_AXS15231B_PANEL=1
27
+ # V2: backlight PWM on GPIO42, active low (the vendor's full brightness
28
+ # is duty 0). Its supply enable and the panel reset are expander pins,
29
+ # driven by panel_reset.cpp.
30
+ GEA_EMBEDDED_AXS15231B_BACKLIGHT_GPIO=42
31
+ GEA_EMBEDDED_AXS15231B_BACKLIGHT_ACTIVE_LOW=1
32
+ GEA_BOARD_PREPARE_DISPLAY_PANEL=1
33
+ GEA_BOARD_AXS15231B_INIT_HEADER="axs15231b_panel_init.h"
34
+ GEA_BOARD_HAS_SDMMC=1
35
+ GEA_BOARD_HAS_SPEAKER=1
36
+ GEA_BOARD_HAS_EXPANDER=1
37
+ GEA_EMBEDDED_DISPLAY_SOFTWARE_LANDSCAPE_PRIMARY=1
38
+ GEA_EMBEDDED_DISPLAY_ROTATE_LANDSCAPE=1
39
+ GEA_EMBEDDED_DISPLAY_RUNTIME_SOFTWARE_ORIENTATION=1
40
+ GEA_EMBEDDED_DISPLAY_DEFAULT_PORTRAIT_PRIMARY=0
41
+ GEA_EMBEDDED_FLUSH_UNITE_ALL=0
42
+ # Like the 3.5B's AXS15231B, this glass cannot reliably restart a write at
43
+ # a nonzero native row: a partial window lands at the wrong place and
44
+ # leaves stale pixels behind. Rasterize damage only, but send the frame
45
+ # from its origin.
46
+ GEA_EMBEDDED_DISPLAY_FULL_FRAME_TRANSFERS=1
47
+ # A full 640x172 frame takes 20-25 ms over QSPI, so free-running lands
48
+ # between 40 and 50 fps and the uneven cadence reads as jitter. Pace a
49
+ # steady 30 fps instead, and drop catch-up frames: a tick that lands mid-frame
50
+ # would otherwise run the next frame back to back and undo the cap.
51
+ GEA_EMBEDDED_DEFAULT_FRAME_INTERVAL_US=33333
52
+ GEA_EMBEDDED_DISPLAY_SPI_TRANSACTION_QUEUE_DEPTH=2
53
+ # The flush pipeline otherwise takes every internal DMA byte left at boot
54
+ # (64 rows x 2), which starves the audio task stack and WiFi.
55
+ GEA_EMBEDDED_DISPLAY_FLUSH_CHUNK_MAX=32
56
+ # Run the runtime on a PSRAM-stacked task and let app_main return, which
57
+ # hands the 32 KB internal main stack back to the heap (BLE, WiFi and the
58
+ # audio task all need internal RAM). Same split as the m5stack stopwatch.
59
+ GEA_EMBEDDED_RUNTIME_TASK_STACK_BYTES=32768
60
+ GEA_EMBEDDED_RUNTIME_TASK_STACK_EXTERNAL=1
61
+ # App native code reads the board name from this string.
62
+ GEA_EMBEDDED_BOARD_ID="${GEA_EMBEDDED_CPP_BOARD}"
63
+ )
64
+
65
+ # Shared ESP32-S3 bootstrap seams; the board's own hardware is selected here
66
+ # and in include/board.h.
67
+ set(GEA_BOARD_PLATFORM_SOURCES
68
+ "${CMAKE_CURRENT_LIST_DIR}/../../esp32-s3-touch-amoled-1.8/main/app_main.cpp"
69
+ "${CMAKE_CURRENT_LIST_DIR}/../../esp32-s3-touch-amoled-1.8/main/i2c.cpp"
70
+ "${CMAKE_CURRENT_LIST_DIR}/../../esp32-s3-touch-amoled-1.8/main/launcher_button.cpp"
71
+ "${CMAKE_CURRENT_LIST_DIR}/touch.cpp"
72
+ "${CMAKE_CURRENT_LIST_DIR}/panel_reset.cpp"
73
+ "${CMAKE_CURRENT_LIST_DIR}/power.cpp"
74
+ "${GEA_CHIPS}/imu/qmi8658/qmi8658.cpp"
75
+ "${GEA_EMBEDDED_ROOT}/targets/esp32/chip_bindings/imu/qmi8658.cpp"
76
+ "${GEA_EMBEDDED_ROOT}/targets/esp32/chip_bindings/audio/es8311.cpp"
77
+ "${GEA_EMBEDDED_ROOT}/targets/esp32/chip_bindings/expanders/tca9554.cpp"
78
+ "${GEA_CHIPS}/displays/sh8601/sh8601.cpp"
79
+ "${GEA_EMBEDDED_ROOT}/targets/esp32/display.cpp"
80
+ "${GEA_EMBEDDED_ROOT}/targets/esp32/chip_bindings/displays/sh8601.cpp"
81
+ )
82
+ include("${CMAKE_CURRENT_LIST_DIR}/../../esp32-s3-touch-amoled-1.8/main/CMakeLists.txt")
@@ -0,0 +1,12 @@
1
+ menu "Gea Embedded"
2
+
3
+ config GEA_EMBEDDED_PRODUCTION_LOCKDOWN
4
+ bool "Production lockdown"
5
+ default n
6
+ help
7
+ Compile out Gea frame/perf logs, heap diagnostics, and the
8
+ diagnostics server for production firmware. Local development builds
9
+ should leave this disabled so serial monitor and VS Code launch
10
+ tasks show fps and diagnostic logs.
11
+
12
+ endmenu
@@ -0,0 +1,42 @@
1
+ {
2
+ "espressif/esp_h264": {
3
+ "when": [
4
+ "network"
5
+ ],
6
+ "dependency": {
7
+ "version": "==1.4.1"
8
+ }
9
+ },
10
+ "78/esp-opus": {
11
+ "when": [
12
+ "network"
13
+ ],
14
+ "dependency": {
15
+ "version": "==1.0.5"
16
+ }
17
+ },
18
+ "espressif/esp_websocket_client": {
19
+ "when": [
20
+ "network"
21
+ ],
22
+ "dependency": {
23
+ "version": "==1.8.0"
24
+ }
25
+ },
26
+ "espressif/esp_peer": {
27
+ "when": [
28
+ "network"
29
+ ],
30
+ "dependency": {
31
+ "version": "==1.5.6"
32
+ }
33
+ },
34
+ "espressif/esp-sr": {
35
+ "when": [
36
+ "aec"
37
+ ],
38
+ "dependency": {
39
+ "version": "==2.5.5"
40
+ }
41
+ }
42
+ }
@@ -0,0 +1,8 @@
1
+ # Always-required SDK dependencies. Optional SDKs are selected from
2
+ # gea-dependencies.json by the CLI capability analyzer.
3
+ dependencies:
4
+ espressif/esp_codec_dev: '==1.6.2'
5
+ espressif/esp_lcd_axs15231b: '==2.1.1'
6
+ # host/websocket.cpp
7
+ idf:
8
+ version: '>=5.3'
@@ -0,0 +1,9 @@
1
+ // Waveshare panel bring-up, from the vendor's ESP-IDF examples
2
+ // (Examples/ESP-IDF/09_LVGL_V8_Test/main/main.cpp). The esp_lcd_axs15231b
3
+ // component itself sends SLPOUT, MADCTL and COLMOD before this list; the
4
+ // factory glass needs nothing beyond a second sleep-out and display-on.
5
+ #pragma once
6
+ static const axs15231b_lcd_init_cmd_t kBoardAxsInitCommands[] = {
7
+ {0x11, (uint8_t[]){0x00}, 0, 120},
8
+ {0x29, (uint8_t[]){0x00}, 0, 100},
9
+ };