feedc0de/esp-idf
1
0
Fork 0
forked from espressif/esp-idf
Code Pull Requests Activity

docs(tools/idf-monitor): add note about CH9102 USB-to-UART bridge issue on Windows

Browse Source 
Closes https://github.com/espressif/esp-idf-monitor/issues/26
This commit is contained in:
Peter Dragun
2025-03-31 13:12:51 +02:00
parent 8a0e310d75
commit 6061a98b33
1 changed files with 8 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
docs/en/api-guides/tools/idf-monitor.rst
View File

@@ -349,7 +349,14 @@ For more details on the configuration file, see the `IDF Monitor documentation`_
Known Issues with IDF Monitor
=============================
If you encounter any issues while using IDF Monitor, check our `GitHub repository <https://github.com/espressif/esp-idf-monitor/issues>`_ for a list of known issues and their current status. If you come across a problem that hasn't been documented yet, we encourage you to create a new issue report.
The following issues are currently known:
- On Windows, if the terminal is closed without first closing the IDF Monitor, some drivers may not release the serial port. To release the port, you may need to unplug and replug the USB cable, or in some cases even restart the computer. This issue has been observed with the CH9102 USB-to-UART bridge. Other drivers, such as CP210x and CH340, should work fine.
To prevent this issue, make sure to close the IDF Monitor properly before exiting the terminal, or consider using an alternative USB-to-UART bridge.
If you experience any other issues while using IDF Monitor, check our `GitHub repository <https://github.com/espressif/esp-idf-monitor/issues>`_ for a list of known issues and their current status. If you come across a problem that hasn't been documented yet, we encourage you to create a new issue report.
.. _esp-idf-monitor: https://github.com/espressif/esp-idf-monitor
.. _IDF Monitor documentation: https://github.com/espressif/esp-idf-monitor/blob/v1.5.0/README.md#documentation