Commit 14c1c8b
docs(esp32p4): correct USB CDC warning — only CDC_ON_BOOT is toxic (#12)
The previous comment lumped ARDUINO_USB_MODE=1 in with
ARDUINO_USB_CDC_ON_BOOT=1 as a flag to avoid. That was wrong.
Per the Arduino-ESP32 core source (cores/esp32/{HWCDC,USBCDC,main}.cpp,
platform.txt):
- ARDUINO_USB_MODE only selects HWCDC vs TinyUSB when CDC_ON_BOOT=1.
With CDC_ON_BOOT=0 (our default) Serial falls back to UART0 regardless
of USB_MODE — the flag has no observable effect.
- =1 selects HWCDC (passive ROM-backed USB-Serial/JTAG). Bounded ~2s
write timeouts; does not wait for host enumeration.
- =0 selects TinyUSB, which IS the stack that blocks waiting for the
host. P4's upstream default is 0; C3/C5/C6/H2/C61 force =1 via
platform.txt.
Update the comment to point users at the actual toxic flag
(CDC_ON_BOOT=1) and explain that USB_MODE is left unset because it
doesn't matter while CDC-on-boot is disabled.
No build-flag changes; comment-only.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>1 parent 021fde7 commit 14c1c8b
1 file changed
Lines changed: 9 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
19 | 19 | | |
20 | 20 | | |
21 | 21 | | |
22 | | - | |
23 | | - | |
24 | | - | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
25 | 31 | | |
26 | 32 | | |
27 | 33 | | |
| |||
0 commit comments