Unverified Commit c4fd3838 authored by lbernstone's avatar lbernstone Committed by GitHub

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: default avatarpedrominatel <pminatel@gmail.com>
parent 14b0b042
......@@ -123,6 +123,18 @@ Sample code to check SDK WPA3 support at compile time:
#warning "No WPA3 support."
#endif
Serial not printing
*******************
I have uploaded firmware to the ESP32 device, but I don't see any response from a Serial.print (HardwareSerial).
Solution
^^^^^^^^
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.
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).
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.
SPIFFS mount failed
-------------------
When you come across an error like this:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment