Skip to content

Commit 49f525c

Browse files
committed
Added Python is missing on the troubleshooting section
1 parent 7a7bd37 commit 49f525c

File tree

1 file changed

+34
-5
lines changed

1 file changed

+34
-5
lines changed

docs/source/troubleshooting.rst

+34-5
Original file line numberDiff line numberDiff line change
@@ -12,39 +12,68 @@ Here are some of the most common issues around the ESP32 development using Ardui
1212
Installing
1313
----------
1414

15+
Here are the common issues during the installation.
16+
1517
Building
1618
--------
1719

20+
Missing Python: "python": executable file not found in $PATH
21+
************************************************************
22+
23+
You are trying to build your sketch using Ubuntu and this message appears:
24+
25+
.. code-block:: bash
26+
27+
"exec: "python": executable file not found in $PATH
28+
Error compiling for board ESP32 Dev Module"
29+
30+
Solution
31+
^^^^^^^^
32+
33+
To avoid this error, you can install the ``python-is-python3`` package to create the symbolic links.
34+
35+
.. code-block:: bash
36+
37+
sudo apt install python-is-python3
38+
39+
If you are not using Ubuntu, you can check if you have the Python correctly installed or the presence of the symbolic links/environment variables.
40+
1841
Flashing
1942
--------
2043

2144
Why is my board not flashing/uploading when I try to upload my sketch?
2245
**********************************************************************
2346

24-
If you are trying to upload a new sketch and your board isn't responding, there are some possible reasons.
2547
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.
48+
If you are trying to upload a new sketch and your board is not responding, there are some possible reasons.
2649

2750
Possible fatal error message from the Arduino IDE:
2851

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

54+
Solution
55+
^^^^^^^^
56+
3157
Here are some steps that you can try to:
3258

3359
* Check your USB cable and try a new one.
3460
* Change the USB port.
3561
* Check your power supply.
36-
* In some instances, you must keep **GPIO0** LOW during the uploading process via serial interface.
37-
* Hold-down the **“BOOT”** button in your ESP32 board while uploading/flashing.
62+
* In some instances, you must keep **GPIO0** LOW during the uploading process via the serial interface.
63+
* Hold down the **“BOOT”** button in your ESP32 board while uploading/flashing.
3864

39-
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.
65+
In some development boards, you can try adding the reset delay circuit, as described 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.
4066

4167
Hardware
4268
--------
4369

4470
Why is my computer not detecting my board?
4571
**************************************************
4672

47-
If your board is not detected after connecting into the USB, you can try to:
73+
If your board is not being detected after connecting to the USB, you can try to:
74+
75+
Solution
76+
^^^^^^^^
4877

4978
* Check if the USB driver is missing. - `USB Driver Download Link <https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers>`_
5079
* Check your USB cable and try a new one.

0 commit comments

Comments
 (0)