Doc: Updated Troubleshooting file #5430
Conversation
Sagar73594
commented
Jul 20, 2021
Sagar73594
commented
- Added some useful troubleshooting tips.
- Fixed a Typo.
- Added some needed points.
Added some useful tips for flashing/programming troubleshooting.
pedrominatel
changed the title
pedrominatel
added
the
Type: Documentation
docs/source/troubleshooting.rst
Outdated
|
|
||
| * Sometimes to program ESP32 via serial you must keep GPIO0 LOW during the programming process. | ||
| * Hold-down the **“BOOT”** button in your ESP32 board while unloading. | ||
| * 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. |
There was a problem hiding this comment.
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.
|
Just to make it clear, the "issue" on getting into the download mode is dependent of the development board. The hardware guide recommends adding the RC delay circuit. |
Thanks for pointing it out. |
Some changes were made.
|
@pedrominatel I have attached a screenshot. Can you suggest to me, why it doesn't look formated as something like that.
|
Are you building the docs using |
* USB Driver download link added. * Link changed for the "ESP32 Hardware Design Guidelines" according to the RST format.
|
@pedrominatel I have removed the line break after Guidelines. Is This okay? |
|
Hi @Sagar73594. In order to get your PR merged, we need to change the format of this troubleshooting as the following. |
* Updated the format. * USB Driver Download Link.
There was a problem hiding this comment.
Hi @Sagar73594. In order to get your PR merged, we need to change the format of this troubleshooting as the following.
Changed.
docs/source/troubleshooting.rst
Outdated
|
|
||
| * Sometimes to program ESP32 via serial you must keep GPIO0 LOW during the programming process. | ||
| * Hold-down the **“BOOT”** button in your ESP32 board while unloading. | ||
| * 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. |
There was a problem hiding this comment.
Just replace the old text in the line 25 to the new one (my comment).
Done.
