Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added troubleshooting doc for USB-CDC #8840

Merged
merged 4 commits into from
Nov 17, 2023

Conversation

lbernstone
Copy link
Contributor

Pretty self-explanatory
PTAL @pedrominatel

@VojtechBartoska VojtechBartoska added Type: Documentation Issue pertains to Documentation of Arduino ESP32 Status: Review needed Issue or PR is awaiting review labels Nov 6, 2023
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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would recommend adding the "Please check in the product product page/datasheet" link to products.espressif.com for the ESP32-X products with the embedded USB-Serial and JTAG.

Copy link
Member

@pedrominatel pedrominatel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@pedrominatel
Copy link
Member

pedrominatel commented Nov 13, 2023

@lbernstone there is a level issue at the line 130 that makes the docs build to fail.

Copy link
Member

@pedrominatel pedrominatel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should fix the CI build error.

@@ -123,6 +123,17 @@ Sample code to check SDK WPA3 support at compile time:
#warning "No WPA3 support."
#endif

Serial not printing
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Change to:

Serial not printing
*******************

@pedrominatel pedrominatel self-requested a review November 14, 2023 16:47
Copy link
Member

@pedrominatel pedrominatel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed and can be merged, @me-no-dev.

@me-no-dev me-no-dev merged commit c4fd383 into espressif:master Nov 17, 2023
37 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Status: Review needed Issue or PR is awaiting review Type: Documentation Issue pertains to Documentation of Arduino ESP32
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants