Skip to content

Doc: Updated Troubleshooting file #5430

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

Merged
merged 13 commits into from
Jul 26, 2021
21 changes: 17 additions & 4 deletions docs/source/troubleshooting.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
###############
Troubleshotting
Troubleshooting
###############

Common Issues
Expand All @@ -18,10 +18,23 @@ Building
Flashing
--------

* The board is not flashing.
*Here are some of the tips if The board is not flashing..*

* In some instances, you must keep **GPIO0** LOW during the uploading process via serial interface.
* Hold-down the **“BOOT”** button in your ESP32 board while uploading/flashing.
* In some ESP32 development boards when trying to upload a new sketch, the Arduino IDE gives you a fatal error *(i.e A fatal error occurred: Failed to connect to ESP32: Timed out waiting for packet header).* This means your ESP32 board is not automatically in the flashing/uploading mode.
Copy link
Member

Choose a reason for hiding this comment

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

When trying to upload a new sketch in some ESP32 development boards, the Arduino IDE gives you a fatal error (i.e A fatal error occurred: Failed to connect to ESP32: Timed out waiting for packet header). This means your ESP32 board is not automatically in the flashing/uploading mode.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Please show me, What I can add/change or do better In this? @pedrominatel

Copy link
Member

Choose a reason for hiding this comment

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

Just replace the old text in the line 25 to the new one (my comment).

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Just replace the old text in the line 25 to the new one (my comment).

Done.

**Solution:**

1. To automatically get into the flashing mode, you have to connect a **10 uF** capacitor between the **EN** and **GND** pins. This capacitor value could be lower (> 2.2 uF) if you don't have this part available. **EN <----||---- GND.** *(The capacitor can be electrolytic, ceramic, or tantalum. Using lower values like 2.2uF and 4.7 uF is also possible in most cases.)*
2. The hardware guide recommends adding the RC delay circuit. For more details, see the **ESP32 Hardware Design Guidelines**
https://www.espressif.com/sites/default/files/documentation/esp32_hardware_design_guidelines_en.pdf

``in the '2.2.1 Power-on Sequence' section.``

Hardware
--------

* Power Source
* Bad USB cable or charging only cables
* Power Source.
* Bad/damaged USB cable or charging only cables (without data wires).
* USB drivers missing.
* Board with some defect.