Skip to content

Commit

Permalink
Doc: Updated Troubleshooting file (#5430)
Browse files Browse the repository at this point in the history
  • Loading branch information
@Sagar73594
Sagar73594 committed Jul 26, 2021
1 parent 3780b5c commit d5a98f9
Showing 1 changed file with 30 additions and 4 deletions.
34 changes: 30 additions & 4 deletions docs/source/troubleshooting.rst
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
###############
Troubleshotting

This comment has been minimized.

Sign in to view

Copy link
@elib555

elib555 Aug 3, 2021

Hi I'm trying to update the esp32 board in the Arduino software and it does not find me I used to grant permissions to
http://arduino.esp8266.com/stable/package_esp8266com_index.json,http://dan.drown.org/stm32duino/package_STM32duino_index.json
Troubleshooting
###############

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

* The board is not flashing.
Why is my board not flashing/uploading when I try to upload my sketch?
**********************************************************************

If you are trying to upload a new sketch and your board isn't responding, there are some possible reasons.
To be able to upload the sketch via serial interface, the ESP32 must be in the download mode. The download mode allows you to upload the sketch over the serial port and to get into it, you need to keep the **GPIO0** in LOW while a resetting (**EN** pin) cycle.

Possible fatal error message from the Arduino IDE:

*A fatal error occurred: Failed to connect to ESP32: Timed out waiting for packet header*

Here are some steps that you can try to:

* Check your USB cable and try a new one.
* Change the USB port.
* Check your power supply.
* 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 development boards, you can try adding the reset delay circuit, as decribed in the *Power-on Sequence* section on the `ESP32 Hardware Design Guidelines <https://www.espressif.com/sites/default/files/documentation/esp32_hardware_design_guidelines_en.pdf>`_ in order to get into the download mode automatically.

Hardware
--------

* Power Source
* Bad USB cable or charging only cables
Why is my computer not detecting my board?
**************************************************

If your board is not detected after connecting into the USB, you can try to:

* Check if the USB driver is missing. - `USB Driver Download Link <https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers>`_
* Check your USB cable and try a new one.
* Change the USB port.
* Check your power supply.
* Check if the board is damaged or defective.

0 comments on commit d5a98f9

Please sign in to comment.