Skip to content

feat(onboarding): Arduino Nano ESP32 stock Arduino row 9/9 over TinyUSB CDC - #1959

Open
w1ne wants to merge 3 commits into
mainfrom
onboarding/nano-esp32-row-20261116
Open

w1ne wants to merge 3 commits into
mainfrom
onboarding/nano-esp32-row-20261116

Conversation

@w1ne

@w1ne w1ne commented Nov 16, 2026

Copy link
Copy Markdown
Owner

Summary

The stock Arduino matrix row on the Arduino Nano ESP32 (ESP32-S3, SKU ABX00092) passes 9 / 9 cells.

Demand rank: ESP32 is 38% of measured usage and Arduino kits are 37% (JetBrains State of Embedded). This is a demand pick.

Evidence

  • examples/arduino-nano-esp32/evidence/arduino-matrix/: per-cell uart.log, result.json, junit.xml and scoreboard.md.
  • Matrix result on 2026-11-16: 9 pass / 0 skip / 0 fail. L2 sees 3 edges on GPIO48 (LED_BUILTIN = D13). L6 sees 59 LEDC edges on GPIO5 (D2).
  • cargo test -p labwired-core --lib usb_otg: 13 passed (rerun after the merge of main).
  • Vendor status, checked live 2026-11-16: DigiKey ABX00092 "Active", 1,061 in stock. The Espressif longevity commitment for ESP32-S3 is at least 12 years from 2021-01-01. See examples/arduino-nano-esp32/vendor-status.md.

Changes

  • ESP32-S3 USB-OTG model. In stock Arduino on this board, Serial is TinyUSB CDC on USB-OTG (ARDUINO_USB_MODE unset). That Serial drops writes until a host opens the port. The model now has a scripted host. The host enumerates the device, sends SET_CONFIGURATION, opens the first CDC-ACM port (DTR) and reads bulk IN data. New unit tests are in usb_otg_tests.rs.
  • Generic console hook. The new Peripheral::attach_usb_cdc_console method sends that CDC data to the console capture. When a named UART is the console, the hook is detached.
  • CLI fast-boot. Both cores now run real register windows. The shadow-window mode and the xthal_window_spill_nw thunk are removed from this path. Before, a task switch on core 1 (from a TinyUSB event) ran esp_event_loop_run on the idle task's window chain, and it asserted in xQueueSemaphoreTake.
  • Matrix files. New board and system files for arduino_nano_esp32. The sketch edits are keyed on ARDUINO_NANO_ESP32 (Wire defaults, A0 constexpr) and on the ESP32-S2/S3 TinyUSB CDC wait for DTR.

Still not modelled

  • PSRAM. The probe reports "PSRAM chip is not connected", and the firmware continues.
  • The board profile in configs/ is not changed. The matrix row uses its own system file.

Each cell costs about 213M steps, because the stock variant runs boot_double_tap_logic() (an RGB fade of about 1 s) before setup().

🤖 Generated with Claude Code

github-actions Bot and others added 3 commits November 16, 2026 00:05
…SB CDC

Stock Arduino on the Nano ESP32 uses TinyUSB CDC on the ESP32-S3 USB-OTG
controller as `Serial` (ARDUINO_USB_MODE unset). The USB-OTG model now has
a scripted host: it enumerates the device, sends SET_CONFIGURATION, opens
the first CDC-ACM port (DTR) and routes bulk IN data into the console
capture via the new generic Peripheral::attach_usb_cdc_console hook.

The CLI fast-boot path now primes faithful register windows on both cores
instead of the shadow-window mode and the xthal_window_spill_nw thunk. A
core-1 interrupt-exit task switch (TinyUSB event) otherwise ran
esp_event_loop_run on the idle task's window chain.

Matrix: 9 pass / 0 skip / 0 fail (L2 3 edges on GPIO48, L6 59 LEDC edges
on GPIO5). Evidence: examples/arduino-nano-esp32/evidence/arduino-matrix/.
Vendor status rechecked live 2026-11-16 (DigiKey ABX00092 Active).
PSRAM is not modelled.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: w1ne <41898282+w1ne@users.noreply.github.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant