espressif/esptool
1
0
Fork 0
mirror of https://github.com/espressif/esptool.git synced 2025-10-16 05:47:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs(troubleshooting): Explain issues when flashing with USB-Serial/JTAG or USB-OTG

Browse Source 
Closes https://github.com/espressif/esptool/issues/924
This commit is contained in:
radim.karnis
2023-10-19 10:47:37 +02:00
parent 20565a0a56
commit 2a399a0dec
1 changed files with 11 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/en/troubleshooting.rst
View File

@@ -102,6 +102,17 @@ Early Stage Crash
Use any of `serial terminal programs`_ to view the boot log. ({IDF_TARGET_NAME} baud rate is 115200bps). See if the program is crashing during early startup or outputting an error message.
.. only:: not esp8266 and not esp32 and not esp32c2
Issues When Using USB-Serial/JTAG or USB-OTG
--------------------------------------------
When working with ESP chips that implement a `USB-Serial/JTAG Controller <https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/api-guides/usb-serial-jtag-console.html>`_ or a `USB-OTG console <https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/api-guides/usb-otg-console.html>`_, it's essential to be aware of potential issues related to the loaded application interfering with or reprogramming the GPIO pins used for USB communication.
If the application accidentally reconfigures the USB peripheral pins or disables the USB peripheral, the device disappears from the system. You can also encounter unstable flashing or errors like ``OSError: [Errno 71] Protocol error``.
If that happens, try :ref:`manually entering the download mode <manual-bootloader>` and then using the :ref:`erase_flash <erase_flash>` command to wipe the flash memory. Then, make sure to fix the issue in the application before flashing again.
Serial Terminal Programs
------------------------