Skip to content

Commit c4fd383

Browse files
Added troubleshooting doc for USB-CDC (#8840)
* Added troubleshooting doc for USB-CDC * Clarification * Change requested by @pedrominatel * Fixed the title level issue --------- Co-authored-by: pedrominatel <[email protected]>
1 parent 14b0b04 commit c4fd383

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

Diff for: docs/source/troubleshooting.rst

+12
Original file line numberDiff line numberDiff line change
@@ -123,6 +123,18 @@ Sample code to check SDK WPA3 support at compile time:
123123
#warning "No WPA3 support."
124124
#endif
125125
126+
Serial not printing
127+
*******************
128+
129+
I have uploaded firmware to the ESP32 device, but I don't see any response from a Serial.print (HardwareSerial).
130+
131+
Solution
132+
^^^^^^^^
133+
134+
Newer ESP32 variants have two possible USB connectors- USB and UART. The UART connector will go through a USB->UART adapter, and will typically present itself with the name of that mfr (eg, Silicon Labs CP210x UART Bridge). The USB connector can be used as a USB-CDC bridge and will appear as an Espressif device (Espressif USB JTAG/serial debug unit). On Espressif devkits, both connections are available, and will be labeled. ESP32 can only use UART, so will only have one connector. Other variants with one connector will typically be using USB. Please check in the product [datasheet](https://products.espressif.com) or [hardware guide](https://www.espressif.com/en/products/devkits) to find Espressif products with the appropriate USB connections for your needs.
135+
If you use the UART connector, you should disable USB-CDC on boot under the Tools menu (-D ARDUINO_USB_CDC_ON_BOOT=0). If you use the USB connector, you should have that enabled (-D ARDUINO_USB_CDC_ON_BOOT=1) and set USB Mode to "Hardware CDC and JTAG" (-D ARDUINO_USB_MODE=0).
136+
USB-CDC may not be able to initialize in time to catch all the data if your device is in a tight reboot loop. This can make it difficult to troubleshoot initialization issues.
137+
126138
SPIFFS mount failed
127139
-------------------
128140
When you come across an error like this:

0 commit comments

Comments
 (0)