kopia lustrzana https://github.com/espressif/esp-idf
57 wiersze
3.1 KiB
ReStructuredText
57 wiersze
3.1 KiB
ReStructuredText
**********************************
|
|
USB Serial/JTAG Controller Console
|
|
**********************************
|
|
|
|
On chips with an integrated USB Serial/JTAG Controller, it is possible to use the part of this controller that implements a serial port (CDC) to implement the serial console, instead of using UART with an external USB-UART bridge chip. {IDF_TARGET_NAME} contains this controller, providing the following functions:
|
|
|
|
* Bidirectional serial console, which can be used with :doc:`IDF Monitor <tools/idf-monitor>` or another serial monitor
|
|
* Flashing using ``esptool.py`` and ``idf.py flash``.
|
|
* JTAG debugging using e.g. OpenOCD, simultaneous with serial operations
|
|
|
|
Note that, in contrast with the USB OTG peripheral found in some Espressif chips, the USB Serial/JTAG Controller is a fixed function device, implemented entirely in hardware. This means it cannot be reconfigured to perform any function other than to provide a serial channel and JTAG debugging functionality.
|
|
|
|
Hardware Requirements
|
|
=====================
|
|
|
|
Connect {IDF_TARGET_NAME} to the USB port as follows:
|
|
|
|
+------+-------------+
|
|
| GPIO | USB |
|
|
+======+=============+
|
|
| 19 | D+ (green) |
|
|
+------+-------------+
|
|
| 18 | D- (white) |
|
|
+------+-------------+
|
|
| GND | GND (black) |
|
|
+------+-------------+
|
|
| | +5V (red) |
|
|
+------+-------------+
|
|
|
|
Some development boards may offer a USB connector for the USB Serial/JTAG Controller — in that case, no extra connections are required.
|
|
|
|
Software Configuration
|
|
======================
|
|
|
|
USB console feature can be enabled using ``CONFIG_ESP_CONSOLE_USB_SERIAL_JTAG`` option in menuconfig tool (see :ref:`CONFIG_ESP_CONSOLE_UART`).
|
|
|
|
Once the option is enabled, build the project as usual.
|
|
|
|
Uploading the Application
|
|
=========================
|
|
|
|
The USB Serial/JTAG Controller is able to put the {IDF_TARGET_NAME} into download mode automatically. Simply flash as usual, but specify the USB Serial/JTAG Controller port on your system: ``idf.py flash -p PORT`` where ``PORT`` is the name of the proper port.
|
|
|
|
Limitations
|
|
===========
|
|
|
|
There are several limitations to the USB console feature. These may or may not be significant, depending on the type of application being developed, and the development workflow.
|
|
|
|
{IDF_TARGET_BOOT_PIN:default = "GPIO0", esp32c3 = "GPIO9"}
|
|
|
|
1. If the application accidentally reconfigures the USB peripheral pins, or disables the USB Serial/JTAG Controller, the device will disappear from the system. After fixing the issue in the application, you will need to manually put the {IDF_TARGET_NAME} into download mode by pulling low {IDF_TARGET_BOOT_PIN} and resetting the chip.
|
|
|
|
2. If the application enters light sleep (including automatic light sleep) or deep sleep mode, USB CDC device will disappear from the system.
|
|
|
|
3. The behaviour between an actual USB-to-serial bridge chip and the USB Serial/JTAG Controller is slightly different if the ESP-IDF application does not listen for incoming bytes. An USB-to-serial bridge chip will just send the bytes to a (not listening) chip, while the USB Serial/JTAG Controller will block until the application reads the bytes. This can lead to a non-responsive looking terminal program.
|
|
|