@typecad/framework-zephyr 1.0.0-alpha.15 → 1.0.0-alpha.18

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 (132) hide show
  1. package/LICENSE +202 -21
  2. package/README.md +49 -87
  3. package/dist/as-built.d.ts +2 -2
  4. package/dist/as-built.js +2 -2
  5. package/dist/boardgen.d.ts +1 -9
  6. package/dist/boardgen.js +228 -45
  7. package/dist/chips/types.d.ts +1 -1
  8. package/dist/debug-codegen.js +1 -1
  9. package/dist/display/touch-adapter.js +1 -1
  10. package/dist/display/ui-adapter.js +549 -549
  11. package/dist/doctor.js +4 -4
  12. package/dist/dt-config/custom-board.js +2 -2
  13. package/dist/dt-config/kconfig.js +18 -12
  14. package/dist/dt-config/overlay.d.ts +2 -2
  15. package/dist/dt-config/overlay.js +2 -2
  16. package/dist/framework.manifest.d.ts +3 -3
  17. package/dist/framework.manifest.js +10 -7
  18. package/dist/index.js +5 -5
  19. package/dist/licenses.d.ts +2 -2
  20. package/dist/licenses.js +8 -8
  21. package/dist/lowering/fs.js +1 -1
  22. package/dist/lowering/gpio.js +0 -32
  23. package/dist/lowering/http.js +264 -32
  24. package/dist/lowering/i2c.js +0 -8
  25. package/dist/lowering/interrupts.js +6 -0
  26. package/dist/lowering/mqtt.js +110 -8
  27. package/dist/lowering/usb.js +11 -11
  28. package/dist/lowering/wdt.js +2 -29
  29. package/dist/sdk/board-catalog-sync.d.ts +1 -3
  30. package/dist/sdk/board-catalog-sync.js +4 -10
  31. package/dist/strategy.d.ts +22 -44
  32. package/dist/strategy.js +152 -155
  33. package/dist/tmp-probe.d.ts +2 -0
  34. package/dist/tmp-probe.js +9 -0
  35. package/dist/toolchain/debug-config.d.ts +50 -90
  36. package/dist/toolchain/debug-config.js +241 -502
  37. package/dist/toolchain/env-check.d.ts +1 -3
  38. package/dist/toolchain/env-check.js +2 -7
  39. package/dist/toolchain/index.d.ts +65 -2
  40. package/dist/toolchain/index.js +432 -55
  41. package/dist/toolchain/runners.d.ts +16 -0
  42. package/dist/toolchain/runners.js +75 -0
  43. package/dist/toolchain/scaffold.d.ts +1 -1
  44. package/dist/toolchain/scaffold.js +12 -12
  45. package/dist/toolchain/west-discover.d.ts +6 -0
  46. package/dist/toolchain/west-discover.js +36 -13
  47. package/dist/toolchain/west-spawn.js +8 -2
  48. package/installer/README.md +328 -328
  49. package/installer/install.sh +2 -2
  50. package/installer/templates/project/.typecad/activate-zephyr.ps1 +1 -1
  51. package/installer/templates/project/.typecad/activate-zephyr.sh +1 -1
  52. package/installer/templates/project/.vscode/settings.json +1 -1
  53. package/installer/templates/project/README.md +2 -2
  54. package/package.json +5 -5
  55. package/src/as-built.ts +206 -206
  56. package/src/boardgen.ts +214 -48
  57. package/src/chips/types.ts +567 -567
  58. package/src/display/touch-adapter.ts +204 -204
  59. package/src/display/ui-adapter.ts +781 -781
  60. package/src/doctor.ts +4 -4
  61. package/src/dt-config/custom-board.ts +2 -2
  62. package/src/dt-config/kconfig.ts +18 -12
  63. package/src/dt-config/overlay.ts +1058 -1058
  64. package/src/framework.manifest.ts +538 -535
  65. package/src/index.ts +5 -5
  66. package/src/licenses.ts +425 -425
  67. package/src/lowering/fs.ts +135 -135
  68. package/src/lowering/gpio.ts +0 -33
  69. package/src/lowering/http.ts +264 -32
  70. package/src/lowering/i2c.ts +0 -9
  71. package/src/lowering/interrupts.ts +6 -0
  72. package/src/lowering/mqtt.ts +109 -8
  73. package/src/lowering/usb.ts +221 -221
  74. package/src/lowering/wdt.ts +2 -25
  75. package/src/sdk/board-catalog-sync.ts +4 -25
  76. package/src/strategy.ts +2265 -2309
  77. package/src/toolchain/debug-config.ts +264 -514
  78. package/src/toolchain/env-check.ts +279 -285
  79. package/src/toolchain/index.ts +1703 -1286
  80. package/src/toolchain/runners.ts +80 -0
  81. package/src/toolchain/scaffold.ts +296 -296
  82. package/src/toolchain/west-discover.ts +35 -13
  83. package/src/toolchain/west-spawn.ts +174 -168
  84. package/dist/async/timer-polyfill.d.ts +0 -10
  85. package/dist/async/timer-polyfill.js +0 -95
  86. package/dist/chips/board-overrides.d.ts +0 -7
  87. package/dist/chips/board-overrides.js +0 -11
  88. package/dist/chips/esp32.d.ts +0 -2
  89. package/dist/chips/esp32.js +0 -71
  90. package/dist/chips/esp32s3.d.ts +0 -2
  91. package/dist/chips/esp32s3.js +0 -103
  92. package/dist/chips/soc/.d.ts +0 -2
  93. package/dist/chips/soc/.js +0 -129
  94. package/dist/chips/soc/esp32.d.ts +0 -2
  95. package/dist/chips/soc/esp32.js +0 -120
  96. package/dist/chips/soc/esp32c3.d.ts +0 -2
  97. package/dist/chips/soc/esp32c3.js +0 -90
  98. package/dist/chips/soc/esp32c6.d.ts +0 -2
  99. package/dist/chips/soc/esp32c6.js +0 -109
  100. package/dist/chips/soc/esp32s3.d.ts +0 -2
  101. package/dist/chips/soc/esp32s3.js +0 -189
  102. package/dist/chips/soc/index.d.ts +0 -2
  103. package/dist/chips/soc/index.js +0 -23
  104. package/dist/chips/soc/nrf52840.d.ts +0 -2
  105. package/dist/chips/soc/nrf52840.js +0 -130
  106. package/dist/chips/soc/rp2040.d.ts +0 -2
  107. package/dist/chips/soc/rp2040.js +0 -141
  108. package/dist/chips/soc/rp2350a.d.ts +0 -2
  109. package/dist/chips/soc/rp2350a.js +0 -145
  110. package/dist/chips/soc/samd21g18a.d.ts +0 -2
  111. package/dist/chips/soc/samd21g18a.js +0 -143
  112. package/dist/chips/soc/stm32f411xe.d.ts +0 -2
  113. package/dist/chips/soc/stm32f411xe.js +0 -251
  114. package/dist/chips/xiao-ble.d.ts +0 -2
  115. package/dist/chips/xiao-ble.js +0 -100
  116. package/dist/lowering/power.d.ts +0 -9
  117. package/dist/lowering/power.js +0 -60
  118. package/dist/lowering/pulse.d.ts +0 -7
  119. package/dist/lowering/pulse.js +0 -51
  120. package/dist/lowering/tone.d.ts +0 -10
  121. package/dist/lowering/tone.js +0 -63
  122. package/dist/lowering/worker-backing.d.ts +0 -14
  123. package/dist/lowering/worker-backing.js +0 -79
  124. package/dist/lowering/worker.d.ts +0 -6
  125. package/dist/lowering/worker.js +0 -14
  126. package/dist/sdk/board-data.generated.d.ts +0 -2
  127. package/dist/sdk/board-data.generated.js +0 -4
  128. package/dist/sdk/catalog-walker.d.ts +0 -90
  129. package/dist/sdk/catalog-walker.js +0 -682
  130. package/dist/sdk/dts-reader.d.ts +0 -83
  131. package/dist/sdk/dts-reader.js +0 -596
  132. package/src/debug-codegen.ts +0 -207
@@ -1,5 +1,5 @@
1
1
  // ---------------------------------------------------------------------------
2
- // Zephyr UI display adapter for the Cuttlefish UI rendering pipeline.
2
+ // Zephyr UI display adapter for the TypeCAD UI rendering pipeline.
3
3
  //
4
4
  // Bridges the in-tree CuttlefishGFX/CuttlefishCanvas16 class (emitted by the
5
5
  // runtime header's cuttlefish-gfx slice) to an SPI TFT panel. The panel is
@@ -155,14 +155,14 @@ export function zephyrUiDisplayAdapter(profile, readback = {}) {
155
155
  // missing and can fail the build).
156
156
  // TE pin: input + rising-edge interrupt (the ST7796 TE pulse), then tell
157
157
  // the controller to drive the line (TEON 0x35, mode 1 = vertical sync only).
158
- const teInit = tePin !== undefined ? `#if __TC_TE_SYNC
159
- if (device_is_ready(__tc_te.port)) {
160
- gpio_pin_configure_dt(&__tc_te, GPIO_INPUT);
161
- gpio_init_callback(&__tc_te_cb, __tc_te_isr, BIT(__tc_te.pin));
162
- (void)gpio_add_callback(__tc_te.port, &__tc_te_cb);
163
- (void)gpio_pin_interrupt_configure_dt(&__tc_te, GPIO_INT_EDGE_RISING);
164
- __tc_pnl_cmd1(0x35, 0x01); // TEON: TE output = vsync pulse
165
- }
158
+ const teInit = tePin !== undefined ? `#if __TC_TE_SYNC
159
+ if (device_is_ready(__tc_te.port)) {
160
+ gpio_pin_configure_dt(&__tc_te, GPIO_INPUT);
161
+ gpio_init_callback(&__tc_te_cb, __tc_te_isr, BIT(__tc_te.pin));
162
+ (void)gpio_add_callback(__tc_te.port, &__tc_te_cb);
163
+ (void)gpio_pin_interrupt_configure_dt(&__tc_te, GPIO_INT_EDGE_RISING);
164
+ __tc_pnl_cmd1(0x35, 0x01); // TEON: TE output = vsync pulse
165
+ }
166
166
  #endif` : '';
167
167
  const blInit = backlightAlias
168
168
  ? `#if DT_HAS_ALIAS(${backlightAlias})\n const struct gpio_dt_spec __bl = GPIO_DT_SPEC_GET(DT_ALIAS(${backlightAlias}), gpios);\n if (device_is_ready(__bl.port)) { gpio_pin_configure_dt(&__bl, GPIO_OUTPUT_ACTIVE); }\n#endif`
@@ -170,558 +170,558 @@ export function zephyrUiDisplayAdapter(profile, readback = {}) {
170
170
  // Per-controller pixel pack/stream helpers. Both share the row-chunked
171
171
  // transport; only the per-pixel wire encoding differs.
172
172
  const pixelHelpers = isIli9341
173
- ? `
174
- // Pack count rgb565 pixels into the row2 scratch buffer as big-endian 16-bit
175
- // wire bytes (c>>8, c&0xFF) — the ILI9341's native 565 format under COLMOD
176
- // 0x55. The caller then streams the buffer with the 8-bit config (one row at
177
- // a time; the buffer holds maxDim pixels).
178
- static void ${packFn}(const uint16_t* px, uint32_t count) {
179
- for (uint32_t i = 0; i < count; i++) {
180
- uint16_t c = px[i];
181
- ${rowBuf}[i * 2] = static_cast<uint8_t>(c >> 8);
182
- ${rowBuf}[i * 2 + 1] = static_cast<uint8_t>(c);
183
- }
184
- }
185
-
186
- // Stream count rgb565 pixels to the panel (chunked through the row2 scratch).
187
- // Caller holds the RAMWR burst.
188
- static void ${pixelsFn}(const uint16_t* px, uint32_t count) {
189
- while (count > 0) {
190
- uint32_t __chunk = (count > ${maxDim}) ? ${maxDim} : count;
191
- ${packFn}(px, __chunk);
192
- struct spi_buf __bd = { ${rowBuf}, static_cast<size_t>(__chunk) * 2U };
193
- struct spi_buf_set __sd = { &__bd, 1 };
194
- (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
195
- px += __chunk;
196
- count -= __chunk;
197
- }
198
- }
173
+ ? `
174
+ // Pack count rgb565 pixels into the row2 scratch buffer as big-endian 16-bit
175
+ // wire bytes (c>>8, c&0xFF) — the ILI9341's native 565 format under COLMOD
176
+ // 0x55. The caller then streams the buffer with the 8-bit config (one row at
177
+ // a time; the buffer holds maxDim pixels).
178
+ static void ${packFn}(const uint16_t* px, uint32_t count) {
179
+ for (uint32_t i = 0; i < count; i++) {
180
+ uint16_t c = px[i];
181
+ ${rowBuf}[i * 2] = static_cast<uint8_t>(c >> 8);
182
+ ${rowBuf}[i * 2 + 1] = static_cast<uint8_t>(c);
183
+ }
184
+ }
185
+
186
+ // Stream count rgb565 pixels to the panel (chunked through the row2 scratch).
187
+ // Caller holds the RAMWR burst.
188
+ static void ${pixelsFn}(const uint16_t* px, uint32_t count) {
189
+ while (count > 0) {
190
+ uint32_t __chunk = (count > ${maxDim}) ? ${maxDim} : count;
191
+ ${packFn}(px, __chunk);
192
+ struct spi_buf __bd = { ${rowBuf}, static_cast<size_t>(__chunk) * 2U };
193
+ struct spi_buf_set __sd = { &__bd, 1 };
194
+ (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
195
+ px += __chunk;
196
+ count -= __chunk;
197
+ }
198
+ }
199
199
  `
200
- : `
201
- // Pack count rgb565 pixels into the row3 scratch buffer as 18-bit (666) wire
202
- // format: (r<<3, g<<2, b<<3) — R,G,B byte order, verified correct on this
203
- // panel in 18-bit mode. The caller then streams the buffer with the 8-bit
204
- // config (one row at a time; the buffer holds maxDim pixels).
205
- static void ${packFn}(const uint16_t* px, uint32_t count) {
206
- for (uint32_t i = 0; i < count; i++) {
207
- uint16_t c = px[i];
208
- ${rowBuf}[i * 3] = static_cast<uint8_t>((c >> 8) & 0xF8u);
209
- ${rowBuf}[i * 3 + 1] = static_cast<uint8_t>((c >> 3) & 0xFCu);
210
- ${rowBuf}[i * 3 + 2] = static_cast<uint8_t>((c << 3) & 0xF8u);
211
- }
212
- }
213
-
214
- // Stream count rgb565 pixels to the panel (converted to 18-bit, chunked
215
- // through the row3 scratch). Caller holds the RAMWR burst.
216
- static void ${pixelsFn}(const uint16_t* px, uint32_t count) {
217
- while (count > 0) {
218
- uint32_t __chunk = (count > ${maxDim}) ? ${maxDim} : count;
219
- ${packFn}(px, __chunk);
220
- struct spi_buf __bd = { ${rowBuf}, static_cast<size_t>(__chunk) * 3U };
221
- struct spi_buf_set __sd = { &__bd, 1 };
222
- (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
223
- px += __chunk;
224
- count -= __chunk;
225
- }
226
- }
200
+ : `
201
+ // Pack count rgb565 pixels into the row3 scratch buffer as 18-bit (666) wire
202
+ // format: (r<<3, g<<2, b<<3) — R,G,B byte order, verified correct on this
203
+ // panel in 18-bit mode. The caller then streams the buffer with the 8-bit
204
+ // config (one row at a time; the buffer holds maxDim pixels).
205
+ static void ${packFn}(const uint16_t* px, uint32_t count) {
206
+ for (uint32_t i = 0; i < count; i++) {
207
+ uint16_t c = px[i];
208
+ ${rowBuf}[i * 3] = static_cast<uint8_t>((c >> 8) & 0xF8u);
209
+ ${rowBuf}[i * 3 + 1] = static_cast<uint8_t>((c >> 3) & 0xFCu);
210
+ ${rowBuf}[i * 3 + 2] = static_cast<uint8_t>((c << 3) & 0xF8u);
211
+ }
212
+ }
213
+
214
+ // Stream count rgb565 pixels to the panel (converted to 18-bit, chunked
215
+ // through the row3 scratch). Caller holds the RAMWR burst.
216
+ static void ${pixelsFn}(const uint16_t* px, uint32_t count) {
217
+ while (count > 0) {
218
+ uint32_t __chunk = (count > ${maxDim}) ? ${maxDim} : count;
219
+ ${packFn}(px, __chunk);
220
+ struct spi_buf __bd = { ${rowBuf}, static_cast<size_t>(__chunk) * 3U };
221
+ struct spi_buf_set __sd = { &__bd, 1 };
222
+ (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
223
+ px += __chunk;
224
+ count -= __chunk;
225
+ }
226
+ }
227
227
  `;
228
228
  // Per-controller solid-fill. Both tile one built row into the block buffer
229
229
  // and stream it in multi-row chunks; only the color encoding differs.
230
230
  const fillRectFn = isIli9341
231
- ? `
232
- static void __tc_op_fillRect(void* /*ctx*/, int16_t x, int16_t y, int16_t rw, int16_t rh, uint16_t c) {
233
- if (rw <= 0 || rh <= 0) return;
234
- uint8_t __b0 = static_cast<uint8_t>(c >> 8);
235
- uint8_t __b1 = static_cast<uint8_t>(c);
236
- // Build one row, then tile it into the block buffer.
237
- for (int16_t i = 0; i < rw; i++) {
238
- ${rowBuf}[i * 2] = __b0;
239
- ${rowBuf}[i * 2 + 1] = __b1;
240
- }
241
- size_t rowBytes = static_cast<size_t>(rw) * 2U;
242
- for (int16_t r = 0; r < __TC_FILL_ROWS; r++) {
243
- memcpy(&${blockBuf}[static_cast<size_t>(r) * rowBytes], ${rowBuf}, rowBytes);
244
- }
245
- __tc_pnl_set_window(x, y, rw, rh);
246
- __tc_pnl_ramwr_begin();
247
- int16_t remaining = rh;
248
- while (remaining > 0) {
249
- int16_t chunk = (remaining > __TC_FILL_ROWS) ? __TC_FILL_ROWS : remaining;
250
- struct spi_buf __bd = { ${blockBuf}, static_cast<size_t>(chunk) * rowBytes };
251
- struct spi_buf_set __sd = { &__bd, 1 };
252
- (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
253
- remaining -= chunk;
254
- }
255
- __tc_pnl_ramwr_end();
256
- }
231
+ ? `
232
+ static void __tc_op_fillRect(void* /*ctx*/, int16_t x, int16_t y, int16_t rw, int16_t rh, uint16_t c) {
233
+ if (rw <= 0 || rh <= 0) return;
234
+ uint8_t __b0 = static_cast<uint8_t>(c >> 8);
235
+ uint8_t __b1 = static_cast<uint8_t>(c);
236
+ // Build one row, then tile it into the block buffer.
237
+ for (int16_t i = 0; i < rw; i++) {
238
+ ${rowBuf}[i * 2] = __b0;
239
+ ${rowBuf}[i * 2 + 1] = __b1;
240
+ }
241
+ size_t rowBytes = static_cast<size_t>(rw) * 2U;
242
+ for (int16_t r = 0; r < __TC_FILL_ROWS; r++) {
243
+ memcpy(&${blockBuf}[static_cast<size_t>(r) * rowBytes], ${rowBuf}, rowBytes);
244
+ }
245
+ __tc_pnl_set_window(x, y, rw, rh);
246
+ __tc_pnl_ramwr_begin();
247
+ int16_t remaining = rh;
248
+ while (remaining > 0) {
249
+ int16_t chunk = (remaining > __TC_FILL_ROWS) ? __TC_FILL_ROWS : remaining;
250
+ struct spi_buf __bd = { ${blockBuf}, static_cast<size_t>(chunk) * rowBytes };
251
+ struct spi_buf_set __sd = { &__bd, 1 };
252
+ (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
253
+ remaining -= chunk;
254
+ }
255
+ __tc_pnl_ramwr_end();
256
+ }
257
257
  `
258
- : `
259
- // Fill a rect row-by-row using the one-row 18-bit scratch buffer. This is the
260
- // hot path for background clears and large fills; building the color into the
261
- // reused buffer and writing each row keeps memory bounded.
262
- // Fill a rect with a solid color. The 18-bit row is tiled into the block buffer
263
- // (__TC_FILL_ROWS rows), then the whole rect is sent in multi-row spi_write
264
- // chunks. A full 480x320 clear is ~40 writes instead of ~320, dropping it from
265
- // ~110ms to ~15ms — the ESP32 SPI driver's per-transaction overhead (not SPI
266
- // bandwidth) is the binding cost, so fewer/larger writes win. Scatter-gather
267
- // descriptor lists tested slower (the driver walks each descriptor), so this
268
- // uses one contiguous buffer per write.
269
- static void __tc_op_fillRect(void* /*ctx*/, int16_t x, int16_t y, int16_t rw, int16_t rh, uint16_t c) {
270
- if (rw <= 0 || rh <= 0) return;
271
- uint8_t __b0 = static_cast<uint8_t>((c >> 8) & 0xF8u);
272
- uint8_t __b1 = static_cast<uint8_t>((c >> 3) & 0xFCu);
273
- uint8_t __b2 = static_cast<uint8_t>((c << 3) & 0xF8u);
274
- // Build one 18-bit row, then tile it into the block buffer.
275
- for (int16_t i = 0; i < rw; i++) {
276
- ${rowBuf}[i * 3] = __b0;
277
- ${rowBuf}[i * 3 + 1] = __b1;
278
- ${rowBuf}[i * 3 + 2] = __b2;
279
- }
280
- size_t rowBytes = static_cast<size_t>(rw) * 3U;
281
- for (int16_t r = 0; r < __TC_FILL_ROWS; r++) {
282
- memcpy(&${blockBuf}[static_cast<size_t>(r) * rowBytes], ${rowBuf}, rowBytes);
283
- }
284
- __tc_pnl_set_window(x, y, rw, rh);
285
- __tc_pnl_ramwr_begin();
286
- int16_t remaining = rh;
287
- while (remaining > 0) {
288
- int16_t chunk = (remaining > __TC_FILL_ROWS) ? __TC_FILL_ROWS : remaining;
289
- struct spi_buf __bd = { ${blockBuf}, static_cast<size_t>(chunk) * rowBytes };
290
- struct spi_buf_set __sd = { &__bd, 1 };
291
- (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
292
- remaining -= chunk;
293
- }
294
- __tc_pnl_ramwr_end();
295
- }
258
+ : `
259
+ // Fill a rect row-by-row using the one-row 18-bit scratch buffer. This is the
260
+ // hot path for background clears and large fills; building the color into the
261
+ // reused buffer and writing each row keeps memory bounded.
262
+ // Fill a rect with a solid color. The 18-bit row is tiled into the block buffer
263
+ // (__TC_FILL_ROWS rows), then the whole rect is sent in multi-row spi_write
264
+ // chunks. A full 480x320 clear is ~40 writes instead of ~320, dropping it from
265
+ // ~110ms to ~15ms — the ESP32 SPI driver's per-transaction overhead (not SPI
266
+ // bandwidth) is the binding cost, so fewer/larger writes win. Scatter-gather
267
+ // descriptor lists tested slower (the driver walks each descriptor), so this
268
+ // uses one contiguous buffer per write.
269
+ static void __tc_op_fillRect(void* /*ctx*/, int16_t x, int16_t y, int16_t rw, int16_t rh, uint16_t c) {
270
+ if (rw <= 0 || rh <= 0) return;
271
+ uint8_t __b0 = static_cast<uint8_t>((c >> 8) & 0xF8u);
272
+ uint8_t __b1 = static_cast<uint8_t>((c >> 3) & 0xFCu);
273
+ uint8_t __b2 = static_cast<uint8_t>((c << 3) & 0xF8u);
274
+ // Build one 18-bit row, then tile it into the block buffer.
275
+ for (int16_t i = 0; i < rw; i++) {
276
+ ${rowBuf}[i * 3] = __b0;
277
+ ${rowBuf}[i * 3 + 1] = __b1;
278
+ ${rowBuf}[i * 3 + 2] = __b2;
279
+ }
280
+ size_t rowBytes = static_cast<size_t>(rw) * 3U;
281
+ for (int16_t r = 0; r < __TC_FILL_ROWS; r++) {
282
+ memcpy(&${blockBuf}[static_cast<size_t>(r) * rowBytes], ${rowBuf}, rowBytes);
283
+ }
284
+ __tc_pnl_set_window(x, y, rw, rh);
285
+ __tc_pnl_ramwr_begin();
286
+ int16_t remaining = rh;
287
+ while (remaining > 0) {
288
+ int16_t chunk = (remaining > __TC_FILL_ROWS) ? __TC_FILL_ROWS : remaining;
289
+ struct spi_buf __bd = { ${blockBuf}, static_cast<size_t>(chunk) * rowBytes };
290
+ struct spi_buf_set __sd = { &__bd, 1 };
291
+ (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
292
+ remaining -= chunk;
293
+ }
294
+ __tc_pnl_ramwr_end();
295
+ }
296
296
  `;
297
297
  // Per-controller init table. Both are byte-for-byte Adafruit sequences
298
298
  // emitted as (cmd, len, data, delay) records walked in display_init.
299
299
  const initBlock = isIli9341
300
- ? `
301
- // ── Panel init ──────────────────────────────────────────────────────────
302
- // Adafruit ILI9341 init sequence (initILI9341), byte for byte: SWRESET,
303
- // manufacturer/power/gamma registers, MADCTL 0x28 (MV landscape + BGR, the
304
- // same convention as the ST7796S path), COLMOD 0x55 (16-bit RGB565 — the
305
- // native wire format of the pack565 transport), SLPOUT (150ms), DISPON
306
- // (150ms), INVON. INVON is included because the common ILI9341 SPI modules
307
- // (2.2"/2.4" TFTs) ship with an inverted panel; the in-tree binding's
308
- // display-inversion property mirrors this for the stock driver.
309
- struct __tc_pnl_init_cmd { uint8_t cmd; uint8_t len; const uint8_t* data; uint16_t delay_ms; };
310
- static const uint8_t __tc_pnl_i1[] = {0x03, 0x80, 0x02};
311
- static const uint8_t __tc_pnl_i2[] = {0x00, 0xC1, 0x30};
312
- static const uint8_t __tc_pnl_i3[] = {0x64, 0x03, 0x12, 0x81};
313
- static const uint8_t __tc_pnl_i4[] = {0x85, 0x00, 0x78};
314
- static const uint8_t __tc_pnl_i5[] = {0x39, 0x2C, 0x00, 0x34, 0x02};
315
- static const uint8_t __tc_pnl_i6[] = {0x20};
316
- static const uint8_t __tc_pnl_i7[] = {0x00, 0x00};
317
- static const uint8_t __tc_pnl_i8[] = {0x23};
318
- static const uint8_t __tc_pnl_i9[] = {0x10};
319
- static const uint8_t __tc_pnl_i10[] = {0x3E, 0x28};
320
- static const uint8_t __tc_pnl_i11[] = {0x86};
321
- static const uint8_t __tc_pnl_i12[] = {0x28};
322
- static const uint8_t __tc_pnl_i13[] = {0x55};
323
- static const uint8_t __tc_pnl_i14[] = {0x00, 0x18};
324
- static const uint8_t __tc_pnl_i15[] = {0x08, 0x82, 0x27};
325
- static const uint8_t __tc_pnl_i16[] = {0x00};
326
- static const uint8_t __tc_pnl_i17[] = {0x01};
327
- static const uint8_t __tc_pnl_i18[] = {0x0F, 0x31, 0x2B, 0x0C, 0x0E, 0x08, 0x4E, 0xF1, 0x37, 0x07, 0x10, 0x03, 0x0E, 0x09, 0x00};
328
- static const uint8_t __tc_pnl_i19[] = {0x00, 0x0E, 0x14, 0x03, 0x11, 0x07, 0x31, 0xC1, 0x48, 0x08, 0x0F, 0x0C, 0x31, 0x36, 0x0F};
329
- static const struct __tc_pnl_init_cmd __tc_pnl_init_seq[] = {
330
- {0x01, 0, NULL, 150}, // SWRESET
331
- {0xEF, 3, __tc_pnl_i1, 0},
332
- {0xCF, 3, __tc_pnl_i2, 0},
333
- {0xED, 4, __tc_pnl_i3, 0},
334
- {0xE8, 3, __tc_pnl_i4, 0},
335
- {0xCB, 5, __tc_pnl_i5, 0},
336
- {0xF7, 1, __tc_pnl_i6, 0},
337
- {0xEA, 2, __tc_pnl_i7, 0},
338
- {0xC0, 1, __tc_pnl_i8, 0}, // PWCTRL1
339
- {0xC1, 1, __tc_pnl_i9, 0}, // PWCTRL2
340
- {0xC5, 2, __tc_pnl_i10, 0}, // VMCTRL1
341
- {0xC7, 1, __tc_pnl_i11, 0}, // VMCTRL2
342
- {0x36, 1, __tc_pnl_i12, 0}, // MADCTL 0x28: MV (landscape) + BGR=1
343
- {0x3A, 1, __tc_pnl_i13, 0}, // COLMOD 0x55 (16-bit RGB565)
344
- {0xB1, 2, __tc_pnl_i14, 0}, // FRMCTR1
345
- {0xB6, 3, __tc_pnl_i15, 0}, // DISCTRL
346
- {0xF2, 1, __tc_pnl_i16, 0}, // ENABLE3G off
347
- {0x26, 1, __tc_pnl_i17, 0}, // GAMSET gamma curve 1
348
- {0xE0, 15, __tc_pnl_i18, 0}, // PGAMCTRL
349
- {0xE1, 15, __tc_pnl_i19, 0}, // NGAMCTRL
350
- {0x11, 0, NULL, 150}, // SLPOUT (sleep out — 120ms typical)
351
- {0x29, 0, NULL, 150}, // DISPON
352
- {0x21, 0, NULL, 0}, // INVON (common ILI9341 modules ship inverted)
353
- };
300
+ ? `
301
+ // ── Panel init ──────────────────────────────────────────────────────────
302
+ // Adafruit ILI9341 init sequence (initILI9341), byte for byte: SWRESET,
303
+ // manufacturer/power/gamma registers, MADCTL 0x28 (MV landscape + BGR, the
304
+ // same convention as the ST7796S path), COLMOD 0x55 (16-bit RGB565 — the
305
+ // native wire format of the pack565 transport), SLPOUT (150ms), DISPON
306
+ // (150ms), INVON. INVON is included because the common ILI9341 SPI modules
307
+ // (2.2"/2.4" TFTs) ship with an inverted panel; the in-tree binding's
308
+ // display-inversion property mirrors this for the stock driver.
309
+ struct __tc_pnl_init_cmd { uint8_t cmd; uint8_t len; const uint8_t* data; uint16_t delay_ms; };
310
+ static const uint8_t __tc_pnl_i1[] = {0x03, 0x80, 0x02};
311
+ static const uint8_t __tc_pnl_i2[] = {0x00, 0xC1, 0x30};
312
+ static const uint8_t __tc_pnl_i3[] = {0x64, 0x03, 0x12, 0x81};
313
+ static const uint8_t __tc_pnl_i4[] = {0x85, 0x00, 0x78};
314
+ static const uint8_t __tc_pnl_i5[] = {0x39, 0x2C, 0x00, 0x34, 0x02};
315
+ static const uint8_t __tc_pnl_i6[] = {0x20};
316
+ static const uint8_t __tc_pnl_i7[] = {0x00, 0x00};
317
+ static const uint8_t __tc_pnl_i8[] = {0x23};
318
+ static const uint8_t __tc_pnl_i9[] = {0x10};
319
+ static const uint8_t __tc_pnl_i10[] = {0x3E, 0x28};
320
+ static const uint8_t __tc_pnl_i11[] = {0x86};
321
+ static const uint8_t __tc_pnl_i12[] = {0x28};
322
+ static const uint8_t __tc_pnl_i13[] = {0x55};
323
+ static const uint8_t __tc_pnl_i14[] = {0x00, 0x18};
324
+ static const uint8_t __tc_pnl_i15[] = {0x08, 0x82, 0x27};
325
+ static const uint8_t __tc_pnl_i16[] = {0x00};
326
+ static const uint8_t __tc_pnl_i17[] = {0x01};
327
+ static const uint8_t __tc_pnl_i18[] = {0x0F, 0x31, 0x2B, 0x0C, 0x0E, 0x08, 0x4E, 0xF1, 0x37, 0x07, 0x10, 0x03, 0x0E, 0x09, 0x00};
328
+ static const uint8_t __tc_pnl_i19[] = {0x00, 0x0E, 0x14, 0x03, 0x11, 0x07, 0x31, 0xC1, 0x48, 0x08, 0x0F, 0x0C, 0x31, 0x36, 0x0F};
329
+ static const struct __tc_pnl_init_cmd __tc_pnl_init_seq[] = {
330
+ {0x01, 0, NULL, 150}, // SWRESET
331
+ {0xEF, 3, __tc_pnl_i1, 0},
332
+ {0xCF, 3, __tc_pnl_i2, 0},
333
+ {0xED, 4, __tc_pnl_i3, 0},
334
+ {0xE8, 3, __tc_pnl_i4, 0},
335
+ {0xCB, 5, __tc_pnl_i5, 0},
336
+ {0xF7, 1, __tc_pnl_i6, 0},
337
+ {0xEA, 2, __tc_pnl_i7, 0},
338
+ {0xC0, 1, __tc_pnl_i8, 0}, // PWCTRL1
339
+ {0xC1, 1, __tc_pnl_i9, 0}, // PWCTRL2
340
+ {0xC5, 2, __tc_pnl_i10, 0}, // VMCTRL1
341
+ {0xC7, 1, __tc_pnl_i11, 0}, // VMCTRL2
342
+ {0x36, 1, __tc_pnl_i12, 0}, // MADCTL 0x28: MV (landscape) + BGR=1
343
+ {0x3A, 1, __tc_pnl_i13, 0}, // COLMOD 0x55 (16-bit RGB565)
344
+ {0xB1, 2, __tc_pnl_i14, 0}, // FRMCTR1
345
+ {0xB6, 3, __tc_pnl_i15, 0}, // DISCTRL
346
+ {0xF2, 1, __tc_pnl_i16, 0}, // ENABLE3G off
347
+ {0x26, 1, __tc_pnl_i17, 0}, // GAMSET gamma curve 1
348
+ {0xE0, 15, __tc_pnl_i18, 0}, // PGAMCTRL
349
+ {0xE1, 15, __tc_pnl_i19, 0}, // NGAMCTRL
350
+ {0x11, 0, NULL, 150}, // SLPOUT (sleep out — 120ms typical)
351
+ {0x29, 0, NULL, 150}, // DISPON
352
+ {0x21, 0, NULL, 0}, // INVON (common ILI9341 modules ship inverted)
353
+ };
354
354
  `
355
- : `
356
- // ── Panel init ──────────────────────────────────────────────────────────
357
- // Adafruit ST7796S init sequence (demo-st lib fork), byte for byte: hw reset
358
- // pulse, SWRESET, manufacturer unlock, VCOM/MADCTL/COLMOD/porch registers,
359
- // lock, SLPOUT (150ms), DISPON (150ms), INVOFF. MADCTL 0x28 = MV (rotation 1
360
- // landscape) + BGR=1. BGR=1 makes the controller route data R/B to the
361
- // B/R subpixels (verified: red data shows blue with BGR=1), which combined
362
- // with a lossless R/B data swap renders the UI correctly; BGR=0 leaves a
363
- // half-lossy G/B quirk on this clone controller.
364
- struct __tc_pnl_init_cmd { uint8_t cmd; uint8_t len; const uint8_t* data; uint16_t delay_ms; };
365
- static const uint8_t __tc_pnl_i1[] = {0xC3};
366
- static const uint8_t __tc_pnl_i2[] = {0x96};
367
- static const uint8_t __tc_pnl_i3[] = {0x1C};
368
- static const uint8_t __tc_pnl_i4[] = {0x28};
369
- static const uint8_t __tc_pnl_i5[] = {0x66};
370
- static const uint8_t __tc_pnl_i6[] = {0x80};
371
- static const uint8_t __tc_pnl_i7[] = {0x00};
372
- static const uint8_t __tc_pnl_i8[] = {0x80, 0x02, 0x3B};
373
- static const uint8_t __tc_pnl_i9[] = {0xC6};
374
- static const uint8_t __tc_pnl_i10[] = {0x69};
375
- static const uint8_t __tc_pnl_i11[] = {0x3C};
376
- static const struct __tc_pnl_init_cmd __tc_pnl_init_seq[] = {
377
- {0x01, 0, NULL, 150}, // SWRESET
378
- {0xF0, 1, __tc_pnl_i1, 0}, // unlock manufacturer
379
- {0xF0, 1, __tc_pnl_i2, 0},
380
- {0xC5, 1, __tc_pnl_i3, 0}, // VCOM control
381
- {0x36, 1, __tc_pnl_i4, 0}, // MADCTL 0x28: MV (rotation 1) + BGR=1
382
- {0x3A, 1, __tc_pnl_i5, 0}, // COLMOD 0x66 (18-bit, 262K) — clean channel routing
383
- {0xB0, 1, __tc_pnl_i6, 0}, // interface control
384
- {0xB4, 1, __tc_pnl_i7, 0}, // inversion control
385
- {0xB6, 3, __tc_pnl_i8, 0}, // display function control
386
- {0xB7, 1, __tc_pnl_i9, 0}, // entry mode
387
- {0xF0, 1, __tc_pnl_i10, 0}, // lock manufacturer
388
- {0xF0, 1, __tc_pnl_i11, 0},
389
- {0x11, 0, NULL, 150}, // SLPOUT (sleep out — 120ms typical)
390
- {0x29, 0, NULL, 150}, // DISPON
391
- {0x20, 0, NULL, 0}, // INVOFF (non-inverted at power-on)
392
- };
355
+ : `
356
+ // ── Panel init ──────────────────────────────────────────────────────────
357
+ // Adafruit ST7796S init sequence (demo-st lib fork), byte for byte: hw reset
358
+ // pulse, SWRESET, manufacturer unlock, VCOM/MADCTL/COLMOD/porch registers,
359
+ // lock, SLPOUT (150ms), DISPON (150ms), INVOFF. MADCTL 0x28 = MV (rotation 1
360
+ // landscape) + BGR=1. BGR=1 makes the controller route data R/B to the
361
+ // B/R subpixels (verified: red data shows blue with BGR=1), which combined
362
+ // with a lossless R/B data swap renders the UI correctly; BGR=0 leaves a
363
+ // half-lossy G/B quirk on this clone controller.
364
+ struct __tc_pnl_init_cmd { uint8_t cmd; uint8_t len; const uint8_t* data; uint16_t delay_ms; };
365
+ static const uint8_t __tc_pnl_i1[] = {0xC3};
366
+ static const uint8_t __tc_pnl_i2[] = {0x96};
367
+ static const uint8_t __tc_pnl_i3[] = {0x1C};
368
+ static const uint8_t __tc_pnl_i4[] = {0x28};
369
+ static const uint8_t __tc_pnl_i5[] = {0x66};
370
+ static const uint8_t __tc_pnl_i6[] = {0x80};
371
+ static const uint8_t __tc_pnl_i7[] = {0x00};
372
+ static const uint8_t __tc_pnl_i8[] = {0x80, 0x02, 0x3B};
373
+ static const uint8_t __tc_pnl_i9[] = {0xC6};
374
+ static const uint8_t __tc_pnl_i10[] = {0x69};
375
+ static const uint8_t __tc_pnl_i11[] = {0x3C};
376
+ static const struct __tc_pnl_init_cmd __tc_pnl_init_seq[] = {
377
+ {0x01, 0, NULL, 150}, // SWRESET
378
+ {0xF0, 1, __tc_pnl_i1, 0}, // unlock manufacturer
379
+ {0xF0, 1, __tc_pnl_i2, 0},
380
+ {0xC5, 1, __tc_pnl_i3, 0}, // VCOM control
381
+ {0x36, 1, __tc_pnl_i4, 0}, // MADCTL 0x28: MV (rotation 1) + BGR=1
382
+ {0x3A, 1, __tc_pnl_i5, 0}, // COLMOD 0x66 (18-bit, 262K) — clean channel routing
383
+ {0xB0, 1, __tc_pnl_i6, 0}, // interface control
384
+ {0xB4, 1, __tc_pnl_i7, 0}, // inversion control
385
+ {0xB6, 3, __tc_pnl_i8, 0}, // display function control
386
+ {0xB7, 1, __tc_pnl_i9, 0}, // entry mode
387
+ {0xF0, 1, __tc_pnl_i10, 0}, // lock manufacturer
388
+ {0xF0, 1, __tc_pnl_i11, 0},
389
+ {0x11, 0, NULL, 150}, // SLPOUT (sleep out — 120ms typical)
390
+ {0x29, 0, NULL, 150}, // DISPON
391
+ {0x20, 0, NULL, 0}, // INVOFF (non-inverted at power-on)
392
+ };
393
393
  `;
394
- const functions = `
395
- // ── Direct panel transport ──────────────────────────────────────────────
396
- // GPIOs: CS/DC/RST driven manually; CS stays LOW for the whole command+data
397
- // burst (DC toggles between command byte and parameters/pixels), matching the
398
- // Adafruit ST77xx protocol this panel requires. The SPI config carries no CS
399
- // (cs_is_gpio = false -> the ESP32 driver's hardware CSEL pin is left idle;
400
- // it is not connected to the panel).
401
- static const struct gpio_dt_spec __tc_pnl_cs = GPIO_DT_SPEC_GET(DT_NODELABEL(${bus}), cs_gpios);
402
- static const struct gpio_dt_spec __tc_pnl_dc = GPIO_DT_SPEC_GET(DT_NODELABEL(${bridge}), dc_gpios);
403
- static const struct gpio_dt_spec __tc_pnl_rst = GPIO_DT_SPEC_GET(DT_NODELABEL(${bridge}), reset_gpios);
404
-
405
- // 8-bit frames for commands/parameters and ${isIli9341 ? '16-bit (2 bytes/pixel)' : '18-bit (3 bytes/pixel)'} pixel data.
406
- static struct spi_config __tc_pnl_cfg8 = {
407
- .frequency = DT_PROP(DT_NODELABEL(${dtLabel}), mipi_max_frequency),
408
- .operation = SPI_OP_MODE_MASTER | SPI_WORD_SET(8),
409
- .slave = 0,
410
- };
411
-
412
- // Assert CS (active=low) unless a startWrite/endWrite batch already holds it.
413
- static inline void __tc_pnl_cs_assert(void) {
414
- if (__tc_pnl_write_depth == 0U) { gpio_pin_set_dt(&__tc_pnl_cs, 1); }
415
- }
416
- // Deassert CS unless a startWrite/endWrite batch is still holding it.
417
- static inline void __tc_pnl_cs_release(void) {
418
- if (__tc_pnl_write_depth == 0U) { gpio_pin_set_dt(&__tc_pnl_cs, 0); }
419
- }
420
-
421
- // Write one command byte (DC low) + its parameters (DC high). CS is asserted
422
- // for the burst unless an outer startWrite is already holding it.
423
- static void __tc_pnl_cmd(uint8_t cmd, const uint8_t* data, uint16_t len) {
424
- struct spi_buf __bc = { &cmd, 1 };
425
- struct spi_buf_set __sc = { &__bc, 1 };
426
- __tc_pnl_cs_assert();
427
- gpio_pin_set_dt(&__tc_pnl_dc, 0);
428
- (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sc);
429
- if (len > 0) {
430
- struct spi_buf __bd = { const_cast<uint8_t*>(data), len };
431
- struct spi_buf_set __sd = { &__bd, 1 };
432
- gpio_pin_set_dt(&__tc_pnl_dc, 1);
433
- (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
434
- }
435
- __tc_pnl_cs_release();
436
- }
437
-
438
- // Open a RAMWR burst: CS low, RAMWR command, DC high for the pixel data.
439
- static void __tc_pnl_ramwr_begin(void) {
440
- uint8_t __ramwr = 0x2C;
441
- struct spi_buf __bc = { &__ramwr, 1 };
442
- struct spi_buf_set __sc = { &__bc, 1 };
443
- __tc_pnl_cs_assert();
444
- gpio_pin_set_dt(&__tc_pnl_dc, 0);
445
- (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sc);
446
- gpio_pin_set_dt(&__tc_pnl_dc, 1);
447
- }
448
-
449
- static void __tc_pnl_ramwr_end(void) { __tc_pnl_cs_release(); }
450
-
451
- // Read ST7796S/ILI9341 GET_SCANLINE (0x45). These controllers return one
452
- // dummy byte followed by the 16-bit scanline. Some modules do not implement
453
- // readback correctly; 0xFFFF means "unknown" and disables waiting for that
454
- // update rather than stalling or corrupting the frame.
455
- static uint16_t __tc_pnl_read_scanline(void) {
456
- if (!__tc_pnl_scanline_sync) return 0xFFFFu;
457
- uint8_t __cmd = 0x45;
458
- uint8_t __tx[3] = {0, 0, 0};
459
- uint8_t __rx[3] = {0, 0, 0};
460
- struct spi_buf __bc = { &__cmd, 1 };
461
- struct spi_buf_set __sc = { &__bc, 1 };
462
- struct spi_buf __bt = { __tx, sizeof(__tx) };
463
- struct spi_buf __br = { __rx, sizeof(__rx) };
464
- struct spi_buf_set __st = { &__bt, 1 };
465
- struct spi_buf_set __sr = { &__br, 1 };
466
- __tc_pnl_cs_assert();
467
- gpio_pin_set_dt(&__tc_pnl_dc, 0);
468
- int __cmd_err = spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sc);
469
- int __read_err = 0;
470
- if (__cmd_err == 0) {
471
- gpio_pin_set_dt(&__tc_pnl_dc, 1);
472
- __read_err = spi_transceive(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__st, &__sr);
473
- }
474
- __tc_pnl_cs_release();
475
- if (__cmd_err != 0 || __read_err != 0) return 0xFFFFu;
476
- uint16_t __line = static_cast<uint16_t>((static_cast<uint16_t>(__rx[1]) << 8) | __rx[2]);
477
- return (__line < ${h}) ? __line : 0xFFFFu;
478
- }
479
-
480
- // Wait until the panel has scanned past a dirty rectangle. This is intentionally
481
- // bounded: a broken/floating SDO must never hang the UI loop. Full-height writes
482
- // have no safe post-rectangle interval, so they retain the normal single-burst
483
- // behavior; the caller's framebuffer still prevents intermediate software frames.
484
- static void __tc_pnl_wait_for_safe_rect(int16_t y, int16_t rh) {
485
- #if __TC_TE_SYNC
486
- // TE variant: arm on the next frame pulse, then start the burst — the write
487
- // chases the scan beam from the top of the rect. Bounded so a stuck TE line
488
- // can never hang the UI loop.
489
- if (rh < 8 || y < 0) return;
490
- uint32_t __was = __tc_te_count;
491
- uint32_t __deadline = k_uptime_get_32() + 25U;
492
- while (__tc_te_count == __was) {
493
- if (static_cast<int32_t>(k_uptime_get_32() - __deadline) >= 0) break;
494
- k_msleep(0);
495
- }
496
- return;
497
- #endif
498
- if (!__tc_pnl_scanline_sync || rh < 8 || y < 0) return;
499
- int16_t __last = static_cast<int16_t>(y + rh - 1);
500
- if (__last >= static_cast<int16_t>(${h} - 2)) return;
501
- uint32_t __deadline = k_uptime_get_32() + 20U;
502
- for (;;) {
503
- uint16_t __line = __tc_pnl_read_scanline();
504
- if (__line == 0xFFFFu || (__line > static_cast<uint16_t>(__last + 2) && __line < static_cast<uint16_t>(${h} - 2))) return;
505
- if (static_cast<int32_t>(k_uptime_get_32() - __deadline) >= 0) return;
506
- k_msleep(0);
507
- }
508
- }
509
- ${pixelHelpers}
510
- // Set the address window. Coordinates are in the effective (rotated) UI
511
- // space; the panel's MADCTL (rotation 1: MV) maps them onto the native
512
- // 320x480 raster, so CASET/RASET take the UI x/y ranges directly.
513
- static void __tc_pnl_set_window(int16_t x, int16_t y, int16_t winW, int16_t winH) {
514
- __tc_pnl_wait_for_safe_rect(y, winH);
515
- uint16_t __x0 = static_cast<uint16_t>(x);
516
- uint16_t __x1 = static_cast<uint16_t>(x + winW - 1);
517
- uint16_t __y0 = static_cast<uint16_t>(y);
518
- uint16_t __y1 = static_cast<uint16_t>(y + winH - 1);
519
- uint8_t __ca[4] = { static_cast<uint8_t>(__x0 >> 8), static_cast<uint8_t>(__x0),
520
- static_cast<uint8_t>(__x1 >> 8), static_cast<uint8_t>(__x1) };
521
- uint8_t __ra[4] = { static_cast<uint8_t>(__y0 >> 8), static_cast<uint8_t>(__y0),
522
- static_cast<uint8_t>(__y1 >> 8), static_cast<uint8_t>(__y1) };
523
- __tc_pnl_cmd(0x2A, __ca, 4);
524
- __tc_pnl_cmd(0x2B, __ra, 4);
525
- }
526
-
527
- // ── Panel-ops consumed by CuttlefishGFX ─────────────────────────────────
528
- // startWrite/endWrite batch multiple primitives under one CS-asserted burst
529
- // (Adafruit ST77xx protocol: CS held low across the burst, DC toggles
530
- // mid-burst). A depth counter supports nested startWrite calls — the runtime
531
- // sometimes wraps a canvas push inside an outer transaction. Only the
532
- // outermost startWrite asserts CS and the outermost endWrite releases it;
533
- // inner ones just bump the depth. This collapses per-primitive CS-toggle
534
- // overhead (one transaction per burst instead of one per rect/glyph row).
535
- static void __tc_op_startWrite(void* /*ctx*/) {
536
- if (__tc_pnl_write_depth == 0U) { gpio_pin_set_dt(&__tc_pnl_cs, 1); }
537
- __tc_pnl_write_depth++;
538
- }
539
- static void __tc_op_endWrite(void* /*ctx*/) {
540
- if (__tc_pnl_write_depth > 0U) {
541
- __tc_pnl_write_depth--;
542
- if (__tc_pnl_write_depth == 0U) { gpio_pin_set_dt(&__tc_pnl_cs, 0); }
543
- }
544
- }
545
-
546
- // Stash the target rect. The runtime always follows this with writePixels
547
- // delivering exactly (w*h) pixels for this rect, OR fillRect/writePixel which
548
- // ignore the stash.
549
- static void __tc_op_setAddrWindow(void* /*ctx*/, int16_t x, int16_t y, int16_t winW, int16_t winH) {
550
- __tc_aw_x = x; __tc_aw_y = y; __tc_aw_w = winW; __tc_aw_h = winH;
551
- }
552
-
553
- // Push the stashed rect's worth of rgb565 pixels. Called right after
554
- // setAddrWindow with exactly (aw_w * aw_h) pixels. The caller's buffer is
555
- // never mutated (scroll canvases persist across frames), so pixels are
556
- // converted in chunks through the row${bpp} scratch buffer.
557
- static void __tc_op_writePixels(void* /*ctx*/, const uint16_t* px, uint32_t n) {
558
- if (n == 0U) return;
559
- __tc_pnl_set_window(__tc_aw_x, __tc_aw_y, __tc_aw_w, __tc_aw_h);
560
- __tc_pnl_ramwr_begin();
561
- ${pixelsFn}(px, n);
562
- __tc_pnl_ramwr_end();
563
- }
564
-
565
- // Single pixel: write a 1x1 rect.
566
- static void __tc_op_writePixel(void* /*ctx*/, int16_t x, int16_t y, uint16_t c) {
567
- uint16_t __c = c;
568
- __tc_pnl_set_window(x, y, 1, 1);
569
- __tc_pnl_ramwr_begin();
570
- ${pixelsFn}(&__c, 1);
571
- __tc_pnl_ramwr_end();
572
- }
573
- ${fillRectFn}
574
- static int16_t __tc_op_width(void* /*ctx*/) { return ${w}; }
575
- static int16_t __tc_op_height(void* /*ctx*/) { return ${h}; }
576
-
577
- // flush is nullptr — direct-mode panel (TFT), no backing store to push.
578
- struct CuttlefishPanelOps;
579
- extern const CuttlefishPanelOps __tc_display_ops;
580
-
581
- const CuttlefishPanelOps __tc_display_ops = {
582
- __tc_op_startWrite,
583
- __tc_op_endWrite,
584
- __tc_op_setAddrWindow,
585
- __tc_op_writePixels,
586
- __tc_op_writePixel,
587
- __tc_op_fillRect,
588
- __tc_op_width,
589
- __tc_op_height,
590
- nullptr, // flush — direct-mode panel
591
- };
592
-
593
- // The live display target: a CuttlefishGFX driven by the panel-ops vtable.
594
- CuttlefishGFX __tc_display(&__tc_display_ops, nullptr);
595
- ${initBlock}
596
- // ── display_init (called from setup) ────────────────────────────────────
597
-
598
- static inline void display_init() {
599
- printk("TC_DISPLAY: device ready\\n");
600
- ${teInit}
601
- ${blInit}
602
- gpio_pin_configure_dt(&__tc_pnl_cs, GPIO_OUTPUT);
603
- gpio_pin_configure_dt(&__tc_pnl_dc, GPIO_OUTPUT);
604
- gpio_pin_configure_dt(&__tc_pnl_rst, GPIO_OUTPUT);
605
- // Hardware reset pulse (Adafruit init behavior).
606
- gpio_pin_set_dt(&__tc_pnl_rst, 1);
607
- k_msleep(20);
608
- gpio_pin_set_dt(&__tc_pnl_rst, 0);
609
- k_msleep(20);
610
- // Adafruit init sequence, direct protocol.
611
- for (uint32_t i = 0; i < (sizeof(__tc_pnl_init_seq) / sizeof(__tc_pnl_init_seq[0])); i++) {
612
- __tc_pnl_cmd(__tc_pnl_init_seq[i].cmd, __tc_pnl_init_seq[i].data,
613
- __tc_pnl_init_seq[i].len);
614
- if (__tc_pnl_init_seq[i].delay_ms > 0) k_msleep(__tc_pnl_init_seq[i].delay_ms);
615
- }
616
- __tc_op_fillRect(nullptr, 0, 0, ${w}, ${h}, 0x0000);
617
- printk("TC_DISPLAY: direct init done (${wireTag}, black fill)\\n");
618
- }
619
-
620
- static inline void display_fillScreen(UI_COLOR_T color) {
621
- __tc_op_fillRect(nullptr, 0, 0, ${w}, ${h}, static_cast<uint16_t>(color));
622
- }
623
- static inline CuttlefishDisplayTarget* display_defaultTarget() { return &__tc_display; }
624
- static inline int16_t display_width() { return ${w}; }
625
- static inline int16_t display_height() { return ${h}; }
626
-
627
- static inline void display_startWrite() { __tc_op_startWrite(nullptr); }
628
- static inline void display_endWrite() { __tc_op_endWrite(nullptr); }
629
- static inline void display_setAddrWindow(int16_t x, int16_t y, int16_t winW, int16_t winH) {
630
- __tc_op_setAddrWindow(nullptr, x, y, winW, winH);
631
- }
632
- static inline void display_writePixels(uint16_t* pixels, uint32_t count) {
633
- __tc_op_writePixels(nullptr, pixels, count);
634
- }
635
-
636
- // ── Canvas lifecycle + accessors (offscreen rgb565 compositing) ──────────
637
- // Allocate the canvas object via malloc + placement-new (not operator new).
638
- // Under CONFIG_REQUIRES_FULL_LIBCPP without CONFIG_CPP_EXCEPTIONS, operator new
639
- // throws std::bad_alloc on OOM and the nothrow wrapper's internal catch cannot
640
- // unwind (no EH runtime) → std::terminate → abort. malloc returns NULL on
641
- // failure with no exception path; placement-new then constructs the object in
642
- // place (vtable included). display_deleteCanvas mirrors with an explicit dtor
643
- // + free. The runtime's callers already null-check the return, so an OOM
644
- // degrades gracefully instead of aborting.
645
- static inline CuttlefishCanvas16* display_createCanvas(int16_t cw, int16_t ch) {
646
- void* mem = malloc(sizeof(CuttlefishCanvas16));
647
- if (!mem) return nullptr;
648
- return new (mem) CuttlefishCanvas16(cw, ch);
649
- }
650
- // psramFound() shim: the Arduino ESP32 core provides this, but Zephyr does not.
651
- // Under BOARD_HAS_PSRAM the ESP heap serves PSRAM, so report it as present. The
652
- // runtime's ui_create_canvas_best calls this under #if defined(BOARD_HAS_PSRAM).
653
- #if defined(BOARD_HAS_PSRAM) && !defined(psramFound)
654
- #include <zephyr/multi_heap/shared_multi_heap.h>
655
- static inline bool psramFound() {
656
- // Compile-time truth: if BOARD_HAS_PSRAM is defined, the build targets a
657
- // PSRAM board with CONFIG_ESP_SPIRAM enabled (the framework emits both).
658
- return true;
659
- }
660
- // Allocate from PSRAM via Zephyr's shared multi-heap (the ESP32 SoC code
661
- // registers PSRAM as an SMH_REG_ATTR_EXTERNAL region at boot).
662
- static inline void* ui_psram_malloc(size_t bytes) {
663
- return shared_multi_heap_alloc(SMH_REG_ATTR_EXTERNAL, bytes);
664
- }
665
- #endif
666
- static inline CuttlefishCanvas16* display_createCanvasPsram(int16_t cw, int16_t ch) {
667
- // Allocate the pixel buffer in PSRAM (large: w*h*2 bytes) and the small
668
- // canvas object in SRAM. The canvas takes ownership of the PSRAM buffer and
669
- // frees it via free() in its dtor (the SMH allocator's free is compatible
670
- // with the standard k_free/free path). Returns nullptr if PSRAM isn't
671
- // available or the allocation fails — ui_create_canvas_best falls back.
672
- #if defined(BOARD_HAS_PSRAM)
673
- if ((cw > 0) && (ch > 0)) {
674
- size_t bytes = static_cast<size_t>(cw) * static_cast<size_t>(ch) * sizeof(uint16_t);
675
- uint16_t* psramBuf = static_cast<uint16_t*>(ui_psram_malloc(bytes));
676
- if (psramBuf) {
677
- void* mem = malloc(sizeof(CuttlefishCanvas16));
678
- if (mem) {
679
- return new (mem) CuttlefishCanvas16(cw, ch, psramBuf, 1);
680
- }
681
- free(psramBuf);
682
- }
683
- }
684
- #else
685
- (void)cw; (void)ch;
686
- #endif
687
- return nullptr;
688
- }
689
- static inline void display_deleteCanvas(CuttlefishCanvas16* canvas) {
690
- if (!canvas) return;
691
- canvas->~CuttlefishCanvas16();
692
- free(canvas);
693
- }
694
- static inline int16_t display_canvasWidth(CuttlefishCanvas16* c) { return c->width(); }
695
- static inline int16_t display_canvasHeight(CuttlefishCanvas16* c) { return c->height(); }
696
- static inline uint16_t* display_canvasBuffer(CuttlefishCanvas16* c) { return c->getBuffer(); }
697
- static inline uint16_t display_canvasGetPixel(CuttlefishCanvas16* c, int16_t x, int16_t y) { return c->getPixel(x, y); }
698
- static inline void display_canvasFillScreen(CuttlefishCanvas16* c, UI_COLOR_T color) { c->fillScreen(static_cast<uint16_t>(color)); }
699
- static inline void display_canvasFillRect(CuttlefishCanvas16* c, int16_t x, int16_t y, int16_t cw, int16_t ch, UI_COLOR_T color) {
700
- c->fillRect(x, y, cw, ch, static_cast<uint16_t>(color));
701
- }
702
-
703
- // ── Target-polymorphic draw (panel or canvas via CuttlefishDisplayTarget*) ─
704
- static inline void display_targetDrawPixel(CuttlefishDisplayTarget* t, int16_t x, int16_t y, UI_COLOR_T color) { t->drawPixel(x, y, static_cast<uint16_t>(color)); }
705
- static inline int16_t display_targetWidth(CuttlefishDisplayTarget* t) { return t->width(); }
706
- static inline int16_t display_targetHeight(CuttlefishDisplayTarget* t) { return t->height(); }
707
- static inline void display_targetDrawRGBBitmap(CuttlefishDisplayTarget* t, int16_t x, int16_t y, const uint16_t* bitmap, int16_t bw, int16_t bh) {
708
- t->drawRGBBitmap(x, y, bitmap, bw, bh);
709
- }
710
- static inline void display_targetFillRect(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, int16_t bh, UI_COLOR_T color) { t->fillRect(x, y, bw, bh, static_cast<uint16_t>(color)); }
711
- static inline void display_targetDrawFastHLine(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, UI_COLOR_T color) { t->drawFastHLine(x, y, bw, static_cast<uint16_t>(color)); }
712
- static inline void display_targetDrawFastVLine(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bh, UI_COLOR_T color) { t->drawFastVLine(x, y, bh, static_cast<uint16_t>(color)); }
713
- static inline void display_targetFillRoundRect(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, int16_t bh, int16_t r, UI_COLOR_T color) { t->fillRoundRect(x, y, bw, bh, r, static_cast<uint16_t>(color)); }
714
- static inline void display_targetDrawRect(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, int16_t bh, UI_COLOR_T color) { t->drawRect(x, y, bw, bh, static_cast<uint16_t>(color)); }
715
- static inline void display_targetDrawRoundRect(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, int16_t bh, int16_t r, UI_COLOR_T color) { t->drawRoundRect(x, y, bw, bh, r, static_cast<uint16_t>(color)); }
716
- static inline void display_targetDrawLine(CuttlefishDisplayTarget* t, int16_t x0, int16_t y0, int16_t x1, int16_t y1, UI_COLOR_T color) { t->drawLine(x0, y0, x1, y1, static_cast<uint16_t>(color)); }
717
- static inline void display_targetFillCircle(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t r, UI_COLOR_T color) { t->fillCircle(x, y, r, static_cast<uint16_t>(color)); }
718
- static inline void display_targetDrawCircle(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t r, UI_COLOR_T color) { t->drawCircle(x, y, r, static_cast<uint16_t>(color)); }
719
- static inline void display_targetSetCursor(CuttlefishDisplayTarget* t, int16_t x, int16_t y) { t->setCursor(x, y); }
720
- static inline void display_targetSetTextColor(CuttlefishDisplayTarget* t, UI_COLOR_T fg) { t->setTextColor(static_cast<uint16_t>(fg)); }
721
- static inline void display_targetSetTextColorBg(CuttlefishDisplayTarget* t, UI_COLOR_T fg, UI_COLOR_T bg) { t->setTextColor(static_cast<uint16_t>(fg), static_cast<uint16_t>(bg)); }
722
- static inline void display_targetSetTextSize(CuttlefishDisplayTarget* t, uint8_t s) { t->setTextSize(s); }
723
- static inline void display_targetSetTextWrap(CuttlefishDisplayTarget* t, bool wp) { t->setTextWrap(wp); }
724
- static inline void display_targetPrint(CuttlefishDisplayTarget* t, const char* s) { t->print(s); }
394
+ const functions = `
395
+ // ── Direct panel transport ──────────────────────────────────────────────
396
+ // GPIOs: CS/DC/RST driven manually; CS stays LOW for the whole command+data
397
+ // burst (DC toggles between command byte and parameters/pixels), matching the
398
+ // Adafruit ST77xx protocol this panel requires. The SPI config carries no CS
399
+ // (cs_is_gpio = false -> the ESP32 driver's hardware CSEL pin is left idle;
400
+ // it is not connected to the panel).
401
+ static const struct gpio_dt_spec __tc_pnl_cs = GPIO_DT_SPEC_GET(DT_NODELABEL(${bus}), cs_gpios);
402
+ static const struct gpio_dt_spec __tc_pnl_dc = GPIO_DT_SPEC_GET(DT_NODELABEL(${bridge}), dc_gpios);
403
+ static const struct gpio_dt_spec __tc_pnl_rst = GPIO_DT_SPEC_GET(DT_NODELABEL(${bridge}), reset_gpios);
404
+
405
+ // 8-bit frames for commands/parameters and ${isIli9341 ? '16-bit (2 bytes/pixel)' : '18-bit (3 bytes/pixel)'} pixel data.
406
+ static struct spi_config __tc_pnl_cfg8 = {
407
+ .frequency = DT_PROP(DT_NODELABEL(${dtLabel}), mipi_max_frequency),
408
+ .operation = SPI_OP_MODE_MASTER | SPI_WORD_SET(8),
409
+ .slave = 0,
410
+ };
411
+
412
+ // Assert CS (active=low) unless a startWrite/endWrite batch already holds it.
413
+ static inline void __tc_pnl_cs_assert(void) {
414
+ if (__tc_pnl_write_depth == 0U) { gpio_pin_set_dt(&__tc_pnl_cs, 1); }
415
+ }
416
+ // Deassert CS unless a startWrite/endWrite batch is still holding it.
417
+ static inline void __tc_pnl_cs_release(void) {
418
+ if (__tc_pnl_write_depth == 0U) { gpio_pin_set_dt(&__tc_pnl_cs, 0); }
419
+ }
420
+
421
+ // Write one command byte (DC low) + its parameters (DC high). CS is asserted
422
+ // for the burst unless an outer startWrite is already holding it.
423
+ static void __tc_pnl_cmd(uint8_t cmd, const uint8_t* data, uint16_t len) {
424
+ struct spi_buf __bc = { &cmd, 1 };
425
+ struct spi_buf_set __sc = { &__bc, 1 };
426
+ __tc_pnl_cs_assert();
427
+ gpio_pin_set_dt(&__tc_pnl_dc, 0);
428
+ (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sc);
429
+ if (len > 0) {
430
+ struct spi_buf __bd = { const_cast<uint8_t*>(data), len };
431
+ struct spi_buf_set __sd = { &__bd, 1 };
432
+ gpio_pin_set_dt(&__tc_pnl_dc, 1);
433
+ (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sd);
434
+ }
435
+ __tc_pnl_cs_release();
436
+ }
437
+
438
+ // Open a RAMWR burst: CS low, RAMWR command, DC high for the pixel data.
439
+ static void __tc_pnl_ramwr_begin(void) {
440
+ uint8_t __ramwr = 0x2C;
441
+ struct spi_buf __bc = { &__ramwr, 1 };
442
+ struct spi_buf_set __sc = { &__bc, 1 };
443
+ __tc_pnl_cs_assert();
444
+ gpio_pin_set_dt(&__tc_pnl_dc, 0);
445
+ (void)spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sc);
446
+ gpio_pin_set_dt(&__tc_pnl_dc, 1);
447
+ }
448
+
449
+ static void __tc_pnl_ramwr_end(void) { __tc_pnl_cs_release(); }
450
+
451
+ // Read ST7796S/ILI9341 GET_SCANLINE (0x45). These controllers return one
452
+ // dummy byte followed by the 16-bit scanline. Some modules do not implement
453
+ // readback correctly; 0xFFFF means "unknown" and disables waiting for that
454
+ // update rather than stalling or corrupting the frame.
455
+ static uint16_t __tc_pnl_read_scanline(void) {
456
+ if (!__tc_pnl_scanline_sync) return 0xFFFFu;
457
+ uint8_t __cmd = 0x45;
458
+ uint8_t __tx[3] = {0, 0, 0};
459
+ uint8_t __rx[3] = {0, 0, 0};
460
+ struct spi_buf __bc = { &__cmd, 1 };
461
+ struct spi_buf_set __sc = { &__bc, 1 };
462
+ struct spi_buf __bt = { __tx, sizeof(__tx) };
463
+ struct spi_buf __br = { __rx, sizeof(__rx) };
464
+ struct spi_buf_set __st = { &__bt, 1 };
465
+ struct spi_buf_set __sr = { &__br, 1 };
466
+ __tc_pnl_cs_assert();
467
+ gpio_pin_set_dt(&__tc_pnl_dc, 0);
468
+ int __cmd_err = spi_write(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__sc);
469
+ int __read_err = 0;
470
+ if (__cmd_err == 0) {
471
+ gpio_pin_set_dt(&__tc_pnl_dc, 1);
472
+ __read_err = spi_transceive(DEVICE_DT_GET(DT_NODELABEL(${bus})), &__tc_pnl_cfg8, &__st, &__sr);
473
+ }
474
+ __tc_pnl_cs_release();
475
+ if (__cmd_err != 0 || __read_err != 0) return 0xFFFFu;
476
+ uint16_t __line = static_cast<uint16_t>((static_cast<uint16_t>(__rx[1]) << 8) | __rx[2]);
477
+ return (__line < ${h}) ? __line : 0xFFFFu;
478
+ }
479
+
480
+ // Wait until the panel has scanned past a dirty rectangle. This is intentionally
481
+ // bounded: a broken/floating SDO must never hang the UI loop. Full-height writes
482
+ // have no safe post-rectangle interval, so they retain the normal single-burst
483
+ // behavior; the caller's framebuffer still prevents intermediate software frames.
484
+ static void __tc_pnl_wait_for_safe_rect(int16_t y, int16_t rh) {
485
+ #if __TC_TE_SYNC
486
+ // TE variant: arm on the next frame pulse, then start the burst — the write
487
+ // chases the scan beam from the top of the rect. Bounded so a stuck TE line
488
+ // can never hang the UI loop.
489
+ if (rh < 8 || y < 0) return;
490
+ uint32_t __was = __tc_te_count;
491
+ uint32_t __deadline = k_uptime_get_32() + 25U;
492
+ while (__tc_te_count == __was) {
493
+ if (static_cast<int32_t>(k_uptime_get_32() - __deadline) >= 0) break;
494
+ k_msleep(0);
495
+ }
496
+ return;
497
+ #endif
498
+ if (!__tc_pnl_scanline_sync || rh < 8 || y < 0) return;
499
+ int16_t __last = static_cast<int16_t>(y + rh - 1);
500
+ if (__last >= static_cast<int16_t>(${h} - 2)) return;
501
+ uint32_t __deadline = k_uptime_get_32() + 20U;
502
+ for (;;) {
503
+ uint16_t __line = __tc_pnl_read_scanline();
504
+ if (__line == 0xFFFFu || (__line > static_cast<uint16_t>(__last + 2) && __line < static_cast<uint16_t>(${h} - 2))) return;
505
+ if (static_cast<int32_t>(k_uptime_get_32() - __deadline) >= 0) return;
506
+ k_msleep(0);
507
+ }
508
+ }
509
+ ${pixelHelpers}
510
+ // Set the address window. Coordinates are in the effective (rotated) UI
511
+ // space; the panel's MADCTL (rotation 1: MV) maps them onto the native
512
+ // 320x480 raster, so CASET/RASET take the UI x/y ranges directly.
513
+ static void __tc_pnl_set_window(int16_t x, int16_t y, int16_t winW, int16_t winH) {
514
+ __tc_pnl_wait_for_safe_rect(y, winH);
515
+ uint16_t __x0 = static_cast<uint16_t>(x);
516
+ uint16_t __x1 = static_cast<uint16_t>(x + winW - 1);
517
+ uint16_t __y0 = static_cast<uint16_t>(y);
518
+ uint16_t __y1 = static_cast<uint16_t>(y + winH - 1);
519
+ uint8_t __ca[4] = { static_cast<uint8_t>(__x0 >> 8), static_cast<uint8_t>(__x0),
520
+ static_cast<uint8_t>(__x1 >> 8), static_cast<uint8_t>(__x1) };
521
+ uint8_t __ra[4] = { static_cast<uint8_t>(__y0 >> 8), static_cast<uint8_t>(__y0),
522
+ static_cast<uint8_t>(__y1 >> 8), static_cast<uint8_t>(__y1) };
523
+ __tc_pnl_cmd(0x2A, __ca, 4);
524
+ __tc_pnl_cmd(0x2B, __ra, 4);
525
+ }
526
+
527
+ // ── Panel-ops consumed by CuttlefishGFX ─────────────────────────────────
528
+ // startWrite/endWrite batch multiple primitives under one CS-asserted burst
529
+ // (Adafruit ST77xx protocol: CS held low across the burst, DC toggles
530
+ // mid-burst). A depth counter supports nested startWrite calls — the runtime
531
+ // sometimes wraps a canvas push inside an outer transaction. Only the
532
+ // outermost startWrite asserts CS and the outermost endWrite releases it;
533
+ // inner ones just bump the depth. This collapses per-primitive CS-toggle
534
+ // overhead (one transaction per burst instead of one per rect/glyph row).
535
+ static void __tc_op_startWrite(void* /*ctx*/) {
536
+ if (__tc_pnl_write_depth == 0U) { gpio_pin_set_dt(&__tc_pnl_cs, 1); }
537
+ __tc_pnl_write_depth++;
538
+ }
539
+ static void __tc_op_endWrite(void* /*ctx*/) {
540
+ if (__tc_pnl_write_depth > 0U) {
541
+ __tc_pnl_write_depth--;
542
+ if (__tc_pnl_write_depth == 0U) { gpio_pin_set_dt(&__tc_pnl_cs, 0); }
543
+ }
544
+ }
545
+
546
+ // Stash the target rect. The runtime always follows this with writePixels
547
+ // delivering exactly (w*h) pixels for this rect, OR fillRect/writePixel which
548
+ // ignore the stash.
549
+ static void __tc_op_setAddrWindow(void* /*ctx*/, int16_t x, int16_t y, int16_t winW, int16_t winH) {
550
+ __tc_aw_x = x; __tc_aw_y = y; __tc_aw_w = winW; __tc_aw_h = winH;
551
+ }
552
+
553
+ // Push the stashed rect's worth of rgb565 pixels. Called right after
554
+ // setAddrWindow with exactly (aw_w * aw_h) pixels. The caller's buffer is
555
+ // never mutated (scroll canvases persist across frames), so pixels are
556
+ // converted in chunks through the row${bpp} scratch buffer.
557
+ static void __tc_op_writePixels(void* /*ctx*/, const uint16_t* px, uint32_t n) {
558
+ if (n == 0U) return;
559
+ __tc_pnl_set_window(__tc_aw_x, __tc_aw_y, __tc_aw_w, __tc_aw_h);
560
+ __tc_pnl_ramwr_begin();
561
+ ${pixelsFn}(px, n);
562
+ __tc_pnl_ramwr_end();
563
+ }
564
+
565
+ // Single pixel: write a 1x1 rect.
566
+ static void __tc_op_writePixel(void* /*ctx*/, int16_t x, int16_t y, uint16_t c) {
567
+ uint16_t __c = c;
568
+ __tc_pnl_set_window(x, y, 1, 1);
569
+ __tc_pnl_ramwr_begin();
570
+ ${pixelsFn}(&__c, 1);
571
+ __tc_pnl_ramwr_end();
572
+ }
573
+ ${fillRectFn}
574
+ static int16_t __tc_op_width(void* /*ctx*/) { return ${w}; }
575
+ static int16_t __tc_op_height(void* /*ctx*/) { return ${h}; }
576
+
577
+ // flush is nullptr — direct-mode panel (TFT), no backing store to push.
578
+ struct CuttlefishPanelOps;
579
+ extern const CuttlefishPanelOps __tc_display_ops;
580
+
581
+ const CuttlefishPanelOps __tc_display_ops = {
582
+ __tc_op_startWrite,
583
+ __tc_op_endWrite,
584
+ __tc_op_setAddrWindow,
585
+ __tc_op_writePixels,
586
+ __tc_op_writePixel,
587
+ __tc_op_fillRect,
588
+ __tc_op_width,
589
+ __tc_op_height,
590
+ nullptr, // flush — direct-mode panel
591
+ };
592
+
593
+ // The live display target: a CuttlefishGFX driven by the panel-ops vtable.
594
+ CuttlefishGFX __tc_display(&__tc_display_ops, nullptr);
595
+ ${initBlock}
596
+ // ── display_init (called from setup) ────────────────────────────────────
597
+
598
+ static inline void display_init() {
599
+ printk("TC_DISPLAY: device ready\\n");
600
+ ${teInit}
601
+ ${blInit}
602
+ gpio_pin_configure_dt(&__tc_pnl_cs, GPIO_OUTPUT);
603
+ gpio_pin_configure_dt(&__tc_pnl_dc, GPIO_OUTPUT);
604
+ gpio_pin_configure_dt(&__tc_pnl_rst, GPIO_OUTPUT);
605
+ // Hardware reset pulse (Adafruit init behavior).
606
+ gpio_pin_set_dt(&__tc_pnl_rst, 1);
607
+ k_msleep(20);
608
+ gpio_pin_set_dt(&__tc_pnl_rst, 0);
609
+ k_msleep(20);
610
+ // Adafruit init sequence, direct protocol.
611
+ for (uint32_t i = 0; i < (sizeof(__tc_pnl_init_seq) / sizeof(__tc_pnl_init_seq[0])); i++) {
612
+ __tc_pnl_cmd(__tc_pnl_init_seq[i].cmd, __tc_pnl_init_seq[i].data,
613
+ __tc_pnl_init_seq[i].len);
614
+ if (__tc_pnl_init_seq[i].delay_ms > 0) k_msleep(__tc_pnl_init_seq[i].delay_ms);
615
+ }
616
+ __tc_op_fillRect(nullptr, 0, 0, ${w}, ${h}, 0x0000);
617
+ printk("TC_DISPLAY: direct init done (${wireTag}, black fill)\\n");
618
+ }
619
+
620
+ static inline void display_fillScreen(UI_COLOR_T color) {
621
+ __tc_op_fillRect(nullptr, 0, 0, ${w}, ${h}, static_cast<uint16_t>(color));
622
+ }
623
+ static inline CuttlefishDisplayTarget* display_defaultTarget() { return &__tc_display; }
624
+ static inline int16_t display_width() { return ${w}; }
625
+ static inline int16_t display_height() { return ${h}; }
626
+
627
+ static inline void display_startWrite() { __tc_op_startWrite(nullptr); }
628
+ static inline void display_endWrite() { __tc_op_endWrite(nullptr); }
629
+ static inline void display_setAddrWindow(int16_t x, int16_t y, int16_t winW, int16_t winH) {
630
+ __tc_op_setAddrWindow(nullptr, x, y, winW, winH);
631
+ }
632
+ static inline void display_writePixels(uint16_t* pixels, uint32_t count) {
633
+ __tc_op_writePixels(nullptr, pixels, count);
634
+ }
635
+
636
+ // ── Canvas lifecycle + accessors (offscreen rgb565 compositing) ──────────
637
+ // Allocate the canvas object via malloc + placement-new (not operator new).
638
+ // Under CONFIG_REQUIRES_FULL_LIBCPP without CONFIG_CPP_EXCEPTIONS, operator new
639
+ // throws std::bad_alloc on OOM and the nothrow wrapper's internal catch cannot
640
+ // unwind (no EH runtime) → std::terminate → abort. malloc returns NULL on
641
+ // failure with no exception path; placement-new then constructs the object in
642
+ // place (vtable included). display_deleteCanvas mirrors with an explicit dtor
643
+ // + free. The runtime's callers already null-check the return, so an OOM
644
+ // degrades gracefully instead of aborting.
645
+ static inline CuttlefishCanvas16* display_createCanvas(int16_t cw, int16_t ch) {
646
+ void* mem = malloc(sizeof(CuttlefishCanvas16));
647
+ if (!mem) return nullptr;
648
+ return new (mem) CuttlefishCanvas16(cw, ch);
649
+ }
650
+ // psramFound() shim: the Arduino ESP32 core provides this, but Zephyr does not.
651
+ // Under BOARD_HAS_PSRAM the ESP heap serves PSRAM, so report it as present. The
652
+ // runtime's ui_create_canvas_best calls this under #if defined(BOARD_HAS_PSRAM).
653
+ #if defined(BOARD_HAS_PSRAM) && !defined(psramFound)
654
+ #include <zephyr/multi_heap/shared_multi_heap.h>
655
+ static inline bool psramFound() {
656
+ // Compile-time truth: if BOARD_HAS_PSRAM is defined, the build targets a
657
+ // PSRAM board with CONFIG_ESP_SPIRAM enabled (the framework emits both).
658
+ return true;
659
+ }
660
+ // Allocate from PSRAM via Zephyr's shared multi-heap (the ESP32 SoC code
661
+ // registers PSRAM as an SMH_REG_ATTR_EXTERNAL region at boot).
662
+ static inline void* ui_psram_malloc(size_t bytes) {
663
+ return shared_multi_heap_alloc(SMH_REG_ATTR_EXTERNAL, bytes);
664
+ }
665
+ #endif
666
+ static inline CuttlefishCanvas16* display_createCanvasPsram(int16_t cw, int16_t ch) {
667
+ // Allocate the pixel buffer in PSRAM (large: w*h*2 bytes) and the small
668
+ // canvas object in SRAM. The canvas takes ownership of the PSRAM buffer and
669
+ // frees it via free() in its dtor (the SMH allocator's free is compatible
670
+ // with the standard k_free/free path). Returns nullptr if PSRAM isn't
671
+ // available or the allocation fails — ui_create_canvas_best falls back.
672
+ #if defined(BOARD_HAS_PSRAM)
673
+ if ((cw > 0) && (ch > 0)) {
674
+ size_t bytes = static_cast<size_t>(cw) * static_cast<size_t>(ch) * sizeof(uint16_t);
675
+ uint16_t* psramBuf = static_cast<uint16_t*>(ui_psram_malloc(bytes));
676
+ if (psramBuf) {
677
+ void* mem = malloc(sizeof(CuttlefishCanvas16));
678
+ if (mem) {
679
+ return new (mem) CuttlefishCanvas16(cw, ch, psramBuf, 1);
680
+ }
681
+ free(psramBuf);
682
+ }
683
+ }
684
+ #else
685
+ (void)cw; (void)ch;
686
+ #endif
687
+ return nullptr;
688
+ }
689
+ static inline void display_deleteCanvas(CuttlefishCanvas16* canvas) {
690
+ if (!canvas) return;
691
+ canvas->~CuttlefishCanvas16();
692
+ free(canvas);
693
+ }
694
+ static inline int16_t display_canvasWidth(CuttlefishCanvas16* c) { return c->width(); }
695
+ static inline int16_t display_canvasHeight(CuttlefishCanvas16* c) { return c->height(); }
696
+ static inline uint16_t* display_canvasBuffer(CuttlefishCanvas16* c) { return c->getBuffer(); }
697
+ static inline uint16_t display_canvasGetPixel(CuttlefishCanvas16* c, int16_t x, int16_t y) { return c->getPixel(x, y); }
698
+ static inline void display_canvasFillScreen(CuttlefishCanvas16* c, UI_COLOR_T color) { c->fillScreen(static_cast<uint16_t>(color)); }
699
+ static inline void display_canvasFillRect(CuttlefishCanvas16* c, int16_t x, int16_t y, int16_t cw, int16_t ch, UI_COLOR_T color) {
700
+ c->fillRect(x, y, cw, ch, static_cast<uint16_t>(color));
701
+ }
702
+
703
+ // ── Target-polymorphic draw (panel or canvas via CuttlefishDisplayTarget*) ─
704
+ static inline void display_targetDrawPixel(CuttlefishDisplayTarget* t, int16_t x, int16_t y, UI_COLOR_T color) { t->drawPixel(x, y, static_cast<uint16_t>(color)); }
705
+ static inline int16_t display_targetWidth(CuttlefishDisplayTarget* t) { return t->width(); }
706
+ static inline int16_t display_targetHeight(CuttlefishDisplayTarget* t) { return t->height(); }
707
+ static inline void display_targetDrawRGBBitmap(CuttlefishDisplayTarget* t, int16_t x, int16_t y, const uint16_t* bitmap, int16_t bw, int16_t bh) {
708
+ t->drawRGBBitmap(x, y, bitmap, bw, bh);
709
+ }
710
+ static inline void display_targetFillRect(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, int16_t bh, UI_COLOR_T color) { t->fillRect(x, y, bw, bh, static_cast<uint16_t>(color)); }
711
+ static inline void display_targetDrawFastHLine(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, UI_COLOR_T color) { t->drawFastHLine(x, y, bw, static_cast<uint16_t>(color)); }
712
+ static inline void display_targetDrawFastVLine(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bh, UI_COLOR_T color) { t->drawFastVLine(x, y, bh, static_cast<uint16_t>(color)); }
713
+ static inline void display_targetFillRoundRect(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, int16_t bh, int16_t r, UI_COLOR_T color) { t->fillRoundRect(x, y, bw, bh, r, static_cast<uint16_t>(color)); }
714
+ static inline void display_targetDrawRect(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, int16_t bh, UI_COLOR_T color) { t->drawRect(x, y, bw, bh, static_cast<uint16_t>(color)); }
715
+ static inline void display_targetDrawRoundRect(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t bw, int16_t bh, int16_t r, UI_COLOR_T color) { t->drawRoundRect(x, y, bw, bh, r, static_cast<uint16_t>(color)); }
716
+ static inline void display_targetDrawLine(CuttlefishDisplayTarget* t, int16_t x0, int16_t y0, int16_t x1, int16_t y1, UI_COLOR_T color) { t->drawLine(x0, y0, x1, y1, static_cast<uint16_t>(color)); }
717
+ static inline void display_targetFillCircle(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t r, UI_COLOR_T color) { t->fillCircle(x, y, r, static_cast<uint16_t>(color)); }
718
+ static inline void display_targetDrawCircle(CuttlefishDisplayTarget* t, int16_t x, int16_t y, int16_t r, UI_COLOR_T color) { t->drawCircle(x, y, r, static_cast<uint16_t>(color)); }
719
+ static inline void display_targetSetCursor(CuttlefishDisplayTarget* t, int16_t x, int16_t y) { t->setCursor(x, y); }
720
+ static inline void display_targetSetTextColor(CuttlefishDisplayTarget* t, UI_COLOR_T fg) { t->setTextColor(static_cast<uint16_t>(fg)); }
721
+ static inline void display_targetSetTextColorBg(CuttlefishDisplayTarget* t, UI_COLOR_T fg, UI_COLOR_T bg) { t->setTextColor(static_cast<uint16_t>(fg), static_cast<uint16_t>(bg)); }
722
+ static inline void display_targetSetTextSize(CuttlefishDisplayTarget* t, uint8_t s) { t->setTextSize(s); }
723
+ static inline void display_targetSetTextWrap(CuttlefishDisplayTarget* t, bool wp) { t->setTextWrap(wp); }
724
+ static inline void display_targetPrint(CuttlefishDisplayTarget* t, const char* s) { t->print(s); }
725
725
  `;
726
726
  return { includes, declaration, functions };
727
727
  }