From 10252a8fb776f2f01001ce5d8f52d1e0af5386f2 Mon Sep 17 00:00:00 2001 From: "igor.masar" Date: Thu, 17 Jul 2025 21:41:54 +0200 Subject: [PATCH 1/2] docs(usb): add section on external USB PHY configuration Add top-level section for configuring and initializing external USB PHY on ESP32-S3. Includes GPIO mapping, code example, and guidance on suspend and speed selection pins. Link to ESP USB PHY guide for SP5301 setup to avoid duplicating content. Add dedicated schematic reference for STUSB03E with analog switch. --- .../usb_device/ext_phy_schematic_stusb03e.png | Bin 0 -> 50353 bytes .../usb_host/ext_phy_schematic_stusb03e.png | Bin 0 -> 1257040 bytes .../api-reference/peripherals/usb_device.rst | 80 +++++++++++++++++- .../en/api-reference/peripherals/usb_host.rst | 71 ++++++++++++++++ 4 files changed, 150 insertions(+), 1 deletion(-) create mode 100644 docs/_static/usb_device/ext_phy_schematic_stusb03e.png create mode 100644 docs/_static/usb_host/ext_phy_schematic_stusb03e.png diff --git a/docs/_static/usb_device/ext_phy_schematic_stusb03e.png b/docs/_static/usb_device/ext_phy_schematic_stusb03e.png new file mode 100644 index 0000000000000000000000000000000000000000..9f4340083261cf409f7fac1a47ffe21e3241b28a GIT binary patch literal 50353 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 literal 0 HcmV?d00001 diff --git a/docs/_static/usb_host/ext_phy_schematic_stusb03e.png b/docs/_static/usb_host/ext_phy_schematic_stusb03e.png new file mode 100644 index 0000000000000000000000000000000000000000..edba55a12925b14383cd96a988ac1c1697c5fcfe GIT binary patch literal 1257040 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 Hl+XkKo^8tT literal 0 HcmV?d00001 diff --git a/docs/en/api-reference/peripherals/usb_device.rst b/docs/en/api-reference/peripherals/usb_device.rst index f4f567aa48..dfcd07af7b 100644 --- a/docs/en/api-reference/peripherals/usb_device.rst +++ b/docs/en/api-reference/peripherals/usb_device.rst @@ -57,6 +57,84 @@ Hardware Connection Self-powered devices must also connect VBUS through a voltage divider or comparator. For more details, please refer to :ref:`self-powered-device`. +.. only:: esp32s3 + + External PHY Configuration + -------------------------- + + The {IDF_TARGET_NAME} contains two USB controllers - the USB-OTG and USB-Serial-JTAG. However, both controllers share a **single PHY**, which means only one can operate at a time. To use USB Device functionality while the USB-Serial-JTAG is active (e.g., for debugging or flashing), an **external PHY** is required, since the PHY is used by USB-Serial-JTAG. + + .. note:: + An external PHY is not the only way to enable debugging alongside USB Host or Device functionality. It is also possible to switch the debugging interface from USB-Serial-JTAG to plain JTAG by burning the appropriate eFuses. For details, refer to the *JTAG Debugging* section in the ESP-IDF Programming Guide for your target. + + {IDF_TARGET_NAME} supports connecting external PHY ICs. This becomes especially relevant when full-speed USB device functionality is needed while the USB-Serial-JTAG controller is also in use. Various external PHY ICs may require different hardware modifications. Please refer to each IC's datasheet for specifics. A general connection diagram can be found in the official ESP documentation: + + `ESP PHY Guide (External PHY Section) `__ + + **List of Tested External PHY ICs:** + + - **SP5301** — Directly supported by {IDF_TARGET_NAME}. See the guide above for schematic and routing information. + - **STUSB03E** — Requires signal routing using an analog switch. See example below. + + .. figure:: ../../../_static/usb_device/ext_phy_schematic_stusb03e.png + :align: center + :alt: External PHY with Analog Switch Schematic (Device mode) + + Example connection using STUSB03E and analog switch (Device mode) + + .. note:: + This schematic is a minimal example intended only to demonstrate the external PHY connection. It omits other essential components and signals (e.g., VCC, GND, RESET) required for a complete, functional {IDF_TARGET_NAME} design. + The schematic includes both a +5V rail (usually from USB VBUS) and a VCC rail. VCC should match the chip supply voltage (usually 3.3V). Ensure that the external PHY and the chip are powered from the same voltage domain. If designing a self-powered USB device, connect VBUSDET signal from the external PHY to {IDF_TARGET_NAME} for mandatory VBUS monitoring. + + Hardware configuration is handled via GPIO mapping to the PHY's pins. Any unused pins (e.g., :cpp:member:`usb_phy_ext_io_conf_t::suspend_n_io_num`, :cpp:member:`usb_phy_ext_io_conf_t::fs_edge_sel_io_num`) **must be set to -1**. + + .. note:: + The :cpp:member:`usb_phy_ext_io_conf_t::suspend_n_io_num` pin is **currently not supported** and does not need to be connected. + The :cpp:member:`usb_phy_ext_io_conf_t::fs_edge_sel_io_num` pin is optional and only required if switching between low-speed and full-speed modes is needed. + + Starting from version 2.0, the ESP TinyUSB Device Stack supports external PHY usage. To use an external PHY in device mode: + + 1. Configure the GPIO mapping and PHY using :cpp:type:`usb_phy_config_t` + 2. Create the PHY using :cpp:func:`usb_new_phy()` + 3. Use :cpp:func:`TINYUSB_DEFAULT_CONFIG()` to initialize :cpp:type:`tinyusb_config_t` + 4. Set the `phy.skip_setup` field of :cpp:type:`tinyusb_config_t` to ``true`` to bypass PHY reinitialization and use the externally configured PHY. + + **Example Code:** + + .. code-block:: c + + // GPIO configuration for external PHY + const usb_phy_ext_io_conf_t ext_io_conf = { + .vp_io_num = 8, + .vm_io_num = 5, + .rcv_io_num = 11, + .oen_io_num = 17, + .vpo_io_num = 4, + .vmo_io_num = 46, + .suspend_n_io_num = -1, + .fs_edge_sel_io_num = -1, + }; + + // Configuration and initialization of external PHY for OTG controller (Device mode) + const usb_phy_config_t phy_config = { + .controller = USB_PHY_CTRL_OTG, + .target = USB_PHY_TARGET_EXT, + .otg_mode = USB_OTG_MODE_DEVICE, + .otg_speed = USB_PHY_SPEED_FULL, + .ext_io_conf = &ext_io_conf + }; + + usb_phy_handle_t phy_hdl; + ESP_ERROR_CHECK(usb_new_phy(&phy_config, &phy_hdl)); + + // Initialize TinyUSB with default configuration (event handler can be set if needed) + tinyusb_config_t config = TINYUSB_DEFAULT_CONFIG(); + config.phy.skip_setup = true; + + tinyusb_driver_install(&config); + + This setup ensures that the USB Device stack uses the **external PHY** instead of attempting to configure the internal one. + Device Stack Structure ---------------------- @@ -145,7 +223,7 @@ To install the Device Stack, please call :cpp:func:`tinyusb_driver_install`. The const tinyusb_config_t partial_init = { .device_descriptor = NULL, // Use the default device descriptor specified in Menuconfig .string_descriptor = NULL, // Use the default string descriptors specified in Menuconfig - .external_phy = false, // Use internal USB PHY + .external_phy = false, // Use internal PHY #if (TUD_OPT_HIGH_SPEED) .fs_configuration_descriptor = NULL, // Use the default full-speed configuration descriptor according to settings in Menuconfig .hs_configuration_descriptor = NULL, // Use the default high-speed configuration descriptor according to settings in Menuconfig diff --git a/docs/en/api-reference/peripherals/usb_host.rst b/docs/en/api-reference/peripherals/usb_host.rst index a389cb604d..8a207a3f4d 100644 --- a/docs/en/api-reference/peripherals/usb_host.rst +++ b/docs/en/api-reference/peripherals/usb_host.rst @@ -407,6 +407,77 @@ UVC .. ---------------------------------------------- USB Host Menuconfig -------------------------------------------------- +.. only:: esp32s3 + + External PHY Configuration + -------------------------- + + The {IDF_TARGET_NAME} contains two USB controllers - the USB-OTG and USB-Serial-JTAG. However, both controllers share a **single PHY**, which means only one can operate at a time. To use USB Host functionality while the USB-Serial-JTAG is active (e.g., for debugging or flashing), an **external PHY** is required, since the PHY is used by USB-Serial-JTAG. + + .. note:: + An external PHY is not the only way to enable debugging alongside USB Host or Device functionality. It is also possible to switch the debugging interface from USB-Serial-JTAG to plain JTAG by burning the appropriate eFuses. For details, refer to the *JTAG Debugging* section in the ESP-IDF Programming Guide for your target. + + {IDF_TARGET_NAME} supports connecting external PHY ICs. This allows independent operation of both USB-OTG and USB-Serial-JTAG controllers. Various external PHY ICs may require different hardware configurations. Please refer to the respective IC datasheets for details. A general connection diagram is available in the official ESP documentation: + + `ESP PHY Guide (External PHY Section) `__ + + **List of Tested External PHY ICs:** + + - **SP5301** — Directly supported by {IDF_TARGET_NAME}. See the guide above for schematic and routing details. + - **STUSB03E** — Requires signal routing using an analog switch. See example below. + + .. figure:: ../../../_static/usb_host/ext_phy_schematic_stusb03e.png + :align: center + :alt: External PHY with Analog Switch Schematic (Host mode) + + Example connection using STUSB03E and analog switch (Host mode) + + .. note:: + This schematic is a minimal example intended only to demonstrate the external PHY connection. It omits other essential components and signals (e.g., VCC, GND, RESET) required for a complete, functional {IDF_TARGET_NAME} design. + The schematic includes both a +5 V rail (used to power USB devices) and a VCC rail (typically 3.3 V). VCC should match the chip supply voltage. Ensure that +5 V for the USB bus is appropriately sourced and protected (e.g., with a power switch and current limiting). Always comply with USB host power requirements, particularly when supporting USB bus-powered devices. + + Hardware configuration is handled via GPIO mapping to the PHY's pins. Any unused pins (e.g., :cpp:member:`usb_phy_ext_io_conf_t::suspend_n_io_num`) **must be set to -1**. + + .. note:: + The :cpp:member:`usb_phy_ext_io_conf_t::suspend_n_io_num` pin is **currently not supported** and does not need to be connected. + + **Example Code:** + + .. code-block:: c + + // GPIO configuration for external PHY + const usb_phy_ext_io_conf_t ext_io_conf = { + .vp_io_num = 8, + .vm_io_num = 5, + .rcv_io_num = 11, + .oen_io_num = 17, + .vpo_io_num = 4, + .vmo_io_num = 46, + .fs_edge_sel_io_num = 38, + .suspend_n_io_num = -1, + }; + + // Configuration and initialization of external PHY for OTG controller (Host mode) + const usb_phy_config_t phy_config = { + .controller = USB_PHY_CTRL_OTG, + .target = USB_PHY_TARGET_EXT, + .otg_mode = USB_OTG_MODE_HOST, + .otg_speed = USB_PHY_SPEED_FULL, + .ext_io_conf = &ext_io_conf + }; + + usb_phy_handle_t phy_hdl; + ESP_ERROR_CHECK(usb_new_phy(&phy_config, &phy_hdl)); + + // Configure USB Host to use the externally initialized PHY + usb_host_config_t host_config = { + .skip_phy_setup = true, + // Add other host configuration fields as needed + }; + ESP_ERROR_CHECK(usb_host_install(&host_config)); + + This setup ensures that the USB Host stack uses the **external PHY** and bypasses PHY setup. + Host Stack Configuration ------------------------ From 8b2b2729bbad9998ead43c21bcc60b2001a197fb Mon Sep 17 00:00:00 2001 From: renpeiying Date: Tue, 12 Aug 2025 15:01:56 +0800 Subject: [PATCH 2/2] docs: Add CN translation to usb_host and usb_device.rst --- docs/_static/usb_device/usb_fs_phy_sp5301.png | Bin 0 -> 127282 bytes .../api-reference/peripherals/usb_device.rst | 20 ++-- .../en/api-reference/peripherals/usb_host.rst | 8 +- .../api-reference/peripherals/usb_device.rst | 86 +++++++++++++++++- .../api-reference/peripherals/usb_host.rst | 69 ++++++++++++++ 5 files changed, 168 insertions(+), 15 deletions(-) create mode 100644 docs/_static/usb_device/usb_fs_phy_sp5301.png diff --git a/docs/_static/usb_device/usb_fs_phy_sp5301.png b/docs/_static/usb_device/usb_fs_phy_sp5301.png new file mode 100644 index 0000000000000000000000000000000000000000..aa20a6043efd3003c161f0f40d5d3cd90f0f97bf GIT binary patch literal 127282 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
  • ok9#qP(> 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 literal 0 HcmV?d00001 diff --git a/docs/en/api-reference/peripherals/usb_device.rst b/docs/en/api-reference/peripherals/usb_device.rst index dfcd07af7b..551b5008de 100644 --- a/docs/en/api-reference/peripherals/usb_device.rst +++ b/docs/en/api-reference/peripherals/usb_device.rst @@ -62,14 +62,18 @@ Hardware Connection External PHY Configuration -------------------------- - The {IDF_TARGET_NAME} contains two USB controllers - the USB-OTG and USB-Serial-JTAG. However, both controllers share a **single PHY**, which means only one can operate at a time. To use USB Device functionality while the USB-Serial-JTAG is active (e.g., for debugging or flashing), an **external PHY** is required, since the PHY is used by USB-Serial-JTAG. + The {IDF_TARGET_NAME} contains two USB controllers: USB-OTG and USB-Serial-JTAG. However, both controllers share a **single PHY**, which means only one can operate at a time. To use USB Device functionality while the USB-Serial-JTAG is active (e.g., for debugging or flashing), an **external PHY** is required, since the PHY is used by USB-Serial-JTAG. .. note:: - An external PHY is not the only way to enable debugging alongside USB Host or Device functionality. It is also possible to switch the debugging interface from USB-Serial-JTAG to plain JTAG by burning the appropriate eFuses. For details, refer to the *JTAG Debugging* section in the ESP-IDF Programming Guide for your target. + An external PHY is not the only way to enable debugging alongside USB Host or Device functionality. It is also possible to switch the debugging interface from USB-Serial-JTAG to plain JTAG by burning the appropriate eFuses. For details, refer to document :doc:`JTAG Debugging <../../api-guides/jtag-debugging/index>` in ESP-IDF Programming Guide for your target. - {IDF_TARGET_NAME} supports connecting external PHY ICs. This becomes especially relevant when full-speed USB device functionality is needed while the USB-Serial-JTAG controller is also in use. Various external PHY ICs may require different hardware modifications. Please refer to each IC's datasheet for specifics. A general connection diagram can be found in the official ESP documentation: + {IDF_TARGET_NAME} supports connecting external PHY ICs. This becomes especially relevant when full-speed USB device functionality is needed while the USB-Serial-JTAG controller is also in use. Various external PHY ICs may require different hardware modifications. Please refer to each IC's datasheet for specifics. A general connection diagram below is provided for reference. For more information, please refer to `Use an external PHY `__. - `ESP PHY Guide (External PHY Section) `__ + .. figure:: ../../../_static/usb_device/usb_fs_phy_sp5301.png + :align: center + :alt: usb_fs_phy_sp5301 + + A typical circuit diagram for an external PHY **List of Tested External PHY ICs:** @@ -84,7 +88,7 @@ Hardware Connection .. note:: This schematic is a minimal example intended only to demonstrate the external PHY connection. It omits other essential components and signals (e.g., VCC, GND, RESET) required for a complete, functional {IDF_TARGET_NAME} design. - The schematic includes both a +5V rail (usually from USB VBUS) and a VCC rail. VCC should match the chip supply voltage (usually 3.3V). Ensure that the external PHY and the chip are powered from the same voltage domain. If designing a self-powered USB device, connect VBUSDET signal from the external PHY to {IDF_TARGET_NAME} for mandatory VBUS monitoring. + The schematic includes both a +5 V rail (usually from USB VBUS) and a VCC rail. VCC should match the chip supply voltage (usually 3.3 V). Ensure that the external PHY and the chip are powered from the same voltage domain. If designing a self-powered USB device, connect VBUSDET signal from the external PHY to {IDF_TARGET_NAME} for mandatory VBUS monitoring. Hardware configuration is handled via GPIO mapping to the PHY's pins. Any unused pins (e.g., :cpp:member:`usb_phy_ext_io_conf_t::suspend_n_io_num`, :cpp:member:`usb_phy_ext_io_conf_t::fs_edge_sel_io_num`) **must be set to -1**. @@ -94,9 +98,9 @@ Hardware Connection Starting from version 2.0, the ESP TinyUSB Device Stack supports external PHY usage. To use an external PHY in device mode: - 1. Configure the GPIO mapping and PHY using :cpp:type:`usb_phy_config_t` - 2. Create the PHY using :cpp:func:`usb_new_phy()` - 3. Use :cpp:func:`TINYUSB_DEFAULT_CONFIG()` to initialize :cpp:type:`tinyusb_config_t` + 1. Configure the GPIO mapping and PHY using :cpp:type:`usb_phy_config_t`. + 2. Create the PHY using :cpp:func:`usb_new_phy()`. + 3. Use :cpp:func:`TINYUSB_DEFAULT_CONFIG()` to initialize :cpp:type:`tinyusb_config_t`. 4. Set the `phy.skip_setup` field of :cpp:type:`tinyusb_config_t` to ``true`` to bypass PHY reinitialization and use the externally configured PHY. **Example Code:** diff --git a/docs/en/api-reference/peripherals/usb_host.rst b/docs/en/api-reference/peripherals/usb_host.rst index 8a207a3f4d..59ccaa85e3 100644 --- a/docs/en/api-reference/peripherals/usb_host.rst +++ b/docs/en/api-reference/peripherals/usb_host.rst @@ -412,14 +412,12 @@ UVC External PHY Configuration -------------------------- - The {IDF_TARGET_NAME} contains two USB controllers - the USB-OTG and USB-Serial-JTAG. However, both controllers share a **single PHY**, which means only one can operate at a time. To use USB Host functionality while the USB-Serial-JTAG is active (e.g., for debugging or flashing), an **external PHY** is required, since the PHY is used by USB-Serial-JTAG. + The {IDF_TARGET_NAME} contains two USB controllers—the USB-OTG and USB-Serial-JTAG. However, both controllers share a **single PHY**, which means only one can operate at a time. To use USB Host functionality while the USB-Serial-JTAG is active (e.g., for debugging or flashing), an **external PHY** is required, since the PHY is used by USB-Serial-JTAG. .. note:: - An external PHY is not the only way to enable debugging alongside USB Host or Device functionality. It is also possible to switch the debugging interface from USB-Serial-JTAG to plain JTAG by burning the appropriate eFuses. For details, refer to the *JTAG Debugging* section in the ESP-IDF Programming Guide for your target. + An external PHY is not the only way to enable debugging alongside USB Host or Device functionality. It is also possible to switch the debugging interface from USB-Serial-JTAG to plain JTAG by burning the appropriate eFuses. For details, refer to the `JTAG Debugging `_ in the ESP-IDF Programming Guide for your target. - {IDF_TARGET_NAME} supports connecting external PHY ICs. This allows independent operation of both USB-OTG and USB-Serial-JTAG controllers. Various external PHY ICs may require different hardware configurations. Please refer to the respective IC datasheets for details. A general connection diagram is available in the official ESP documentation: - - `ESP PHY Guide (External PHY Section) `__ + {IDF_TARGET_NAME} supports connecting external PHY ICs. This allows independent operation of both USB-OTG and USB-Serial-JTAG controllers. Various external PHY ICs may require different hardware configurations. Please refer to the respective IC datasheets for details. A general connection diagram is available in the official ESP documentation: `Use an external PHY `__. **List of Tested External PHY ICs:** diff --git a/docs/zh_CN/api-reference/peripherals/usb_device.rst b/docs/zh_CN/api-reference/peripherals/usb_device.rst index 8c3d708c5c..fb40260f0c 100644 --- a/docs/zh_CN/api-reference/peripherals/usb_device.rst +++ b/docs/zh_CN/api-reference/peripherals/usb_device.rst @@ -40,7 +40,7 @@ USB 设备栈(以下简称设备栈)支持在 {IDF_TARGET_NAME} 上启用 US .. only:: esp32p4 - {IDF_TARGET_NAME} 将 USB D+ 和 D- 信号路由到其专用引脚。为了实现 USB 设备功能,这些引脚应通过某种方式连接到总线(例如,通过 Micro-B 端口、USB-C 端口或直接连接到标准-A 插头)。 + {IDF_TARGET_NAME} 将 USB D+ 和 D- 信号路由到其专用管脚。为了实现 USB 设备功能,这些管脚应通过某种方式连接到总线(例如,通过 Micro-B 端口、USB-C 端口或直接连接到标准-A 插头)。 .. figure:: ../../../_static/usb-board-connection.png :align: center @@ -57,6 +57,88 @@ USB 设备栈(以下简称设备栈)支持在 {IDF_TARGET_NAME} 上启用 US 自供电设备还必须通过电压分压器或比较器连接 VBUS,详情请参阅 :ref:`self-powered-device`。 +.. only:: esp32s3 + + 外部 PHY 配置 + ------------- + + {IDF_TARGET_NAME} 内部集成了两个 USB 控制器:USB-OTG 与 USB-Serial-JTAG。这两个控制器 **共用同一个 PHY**,因此同一时间只能有一个控制器工作。如果在 USB-Serial-JTAG 工作时(例如调试或烧录)时仍需要使用 USB 设备功能,必须使用 **外部 PHY**,因为此时内部 PHY 已被 USB-Serial-JTAG 占用。 + + .. note:: + 使用外部 PHY 并不是在 USB 主机或设备功能开启时同时实现调试的唯一办法。也可以通过烧录对应的 eFuse,将调试接口从 USB-Serial-JTAG 切换为传统的 JTAG 接口。具体步骤请参考 ESP-IDF 编程指南中针对你的芯片的 :doc:`JTAG 调试 <../../api-guides/jtag-debugging/index>` 章节。 + + {IDF_TARGET_NAME} 支持连接外部 PHY 芯片。当需要在使用 USB-Serial-JTAG 控制器的同时提供全速 USB 设备功能时,这一点尤其重要。不同的外部 PHY 芯片可能需要不同的硬件配置,请参考各自芯片的规格书。乐鑫官方文档提供了如下的通用连接示意图供参考。如需了解更多内容,请参阅 `使用外部 PHY `__。 + + .. figure:: ../../../_static/usb_device/usb_fs_phy_sp5301.png + :align: center + :alt: usb_fs_phy_sp5301 + + 连接外部 PHY 芯片的典型电路图 + + **已测试的外部 PHY 芯片如下:** + + - **SP5301** — {IDF_TARGET_NAME} 原生支持此芯片。原理图与布线方法请参考上文链接。 + - **STUSB03E** — 需要通过模拟开关进行信号切换,详情参考下方示例。 + + .. figure:: ../../../_static/usb_device/ext_phy_schematic_stusb03e.png + :align: center + :alt: 使用模拟开关的外部 PHY 原理图(设备模式) + + 使用 STUSB03E 与模拟开关的连接示例(设备模式) + + .. note:: + 此原理图仅为简化示例,用于展示外部 PHY 的连接方式,未包含完整 {IDF_TARGET_NAME} 设计所需的所有元件和信号(如 VCC、GND、RESET 等)。 + 图中包含 +5 V 电源轨(通常来自 USB VBUS)和 VCC 电源轨。VCC 电压应与芯片供电电压一致(通常为 3.3 V),并确保外部 PHY 与芯片使用同一电压域供电。如果设计自供电 USB 设备,请将外部 PHY 的 VBUSDET 信号接入 {IDF_TARGET_NAME},以便实现对 VBUS 电压状态的监控。 + + 硬件配置通过将 GPIO 映射到 PHY 管脚实现。任何未使用的管脚(如 :cpp:member:`usb_phy_ext_io_conf_t::suspend_n_io_num`、:cpp:member:`usb_phy_ext_io_conf_t::fs_edge_sel_io_num`) **必须设置为 -1**。 + + .. note:: + :cpp:member:`usb_phy_ext_io_conf_t::suspend_n_io_num` 管脚 **当前不受支持**,无需连接。 + :cpp:member:`usb_phy_ext_io_conf_t::fs_edge_sel_io_num` 管脚为可选管脚,仅需在低速和全速模式间切换时使用。 + + ESP TinyUSB 设备栈从 2.0 版本开始支持外部 PHY。要在设备模式下使用外部 PHY,需执行以下步骤: + + 1. 使用 :cpp:type:`usb_phy_config_t` 配置 GPIO 映射与 PHY。 + 2. 调用 :cpp:func:`usb_new_phy()` 创建 PHY。 + 3. 使用 :cpp:func:`TINYUSB_DEFAULT_CONFIG()` 初始化 :cpp:type:`tinyusb_config_t`。 + 4. 将 :cpp:type:`tinyusb_config_t` 的 `phy.skip_setup` 字段设为 ``true``,从而跳过 PHY 的重新初始化,直接使用已配置的外部 PHY。 + + **示例代码:** + + .. code-block:: c + + // 外部 PHY 的 GPIO 配置 + const usb_phy_ext_io_conf_t ext_io_conf = { + .vp_io_num = 8, + .vm_io_num = 5, + .rcv_io_num = 11, + .oen_io_num = 17, + .vpo_io_num = 4, + .vmo_io_num = 46, + .suspend_n_io_num = -1, + .fs_edge_sel_io_num = -1, + }; + + // 针对 OTG 控制器(设备模式)的外部 PHY 配置与初始化 + const usb_phy_config_t phy_config = { + .controller = USB_PHY_CTRL_OTG, + .target = USB_PHY_TARGET_EXT, + .otg_mode = USB_OTG_MODE_DEVICE, + .otg_speed = USB_PHY_SPEED_FULL, + .ext_io_conf = &ext_io_conf + }; + + usb_phy_handle_t phy_hdl; + ESP_ERROR_CHECK(usb_new_phy(&phy_config, &phy_hdl)); + + // 使用默认配置初始化 TinyUSB(可根据需要设置事件处理函数) + tinyusb_config_t config = TINYUSB_DEFAULT_CONFIG(); + config.phy.skip_setup = true; + + tinyusb_driver_install(&config); + + 通过上述配置,USB 设备栈会直接使用 **外部 PHY**,而不会尝试配置内部 PHY。 + 设备栈结构 ---------- @@ -170,7 +252,7 @@ USB 规范要求自供电设备监测 USB 的 VBUS 信号的电压水平。与 .. note:: - 在这两种情况下,设备从 USB 主机拔出后 3 毫秒内,传感引脚上的电压必须为逻辑低电平。 + 在这两种情况下,设备从 USB 主机拔出后 3 毫秒内,传感管脚上的电压必须为逻辑低电平。 .. figure:: ../../../_static/diagrams/usb/usb_vbus_voltage_monitor.png :align: center diff --git a/docs/zh_CN/api-reference/peripherals/usb_host.rst b/docs/zh_CN/api-reference/peripherals/usb_host.rst index b006f36ebe..fef74b0693 100644 --- a/docs/zh_CN/api-reference/peripherals/usb_host.rst +++ b/docs/zh_CN/api-reference/peripherals/usb_host.rst @@ -407,6 +407,75 @@ UVC .. ---------------------------------------------- USB Host Menuconfig -------------------------------------------------- +.. only:: esp32s3 + + 外部 PHY 配置 + ------------- + + {IDF_TARGET_NAME} 内部集成了两个 USB 控制器 —— USB-OTG 和 USB-Serial-JTAG。这两个控制器 **共用同一个 PHY**,因此同一时间只能有一个控制器工作。如果在 USB-Serial-JTAG 工作时(如调试或烧录)时仍需使用 USB 主机功能,必须使用 **外部 PHY**,因为此时内部 PHY 已被 USB-Serial-JTAG 占用。 + + .. note:: + 使用外部 PHY 并不是在 USB 主机或设备功能开启时同时实现调试的唯一办法。也可以通过烧录对应的 eFuse,将调试接口从 USB-Serial-JTAG 切换为传统的 JTAG 接口。具体步骤请参考 ESP-IDF 编程指南中针对你的芯片的 `JTAG 调试 `_ 章节。 + + {IDF_TARGET_NAME} 支持连接外部 PHY 芯片,从而实现 USB-OTG 和 USB-Serial-JTAG 控制器的独立工作。不同的外部 PHY 芯片可能需要不同的硬件配置,具体请参阅各芯片的规格书。乐鑫官方文档提供了通用的连接示意图用于参考:`使用外部 PHY `__。 + + **已测试的外部 PHY 芯片如下:** + + - **SP5301** — {IDF_TARGET_NAME} 原生支持此芯片。原理图与布线方法请参考上文链接。 + - **STUSB03E** — 需要通过模拟开关进行信号路由。请参考下方示例。 + + .. figure:: ../../../_static/usb_host/ext_phy_schematic_stusb03e.png + :align: center + :alt: 使用模拟开关的外部 PHY 原理图(主机模式) + + 使用 STUSB03E 与模拟开关的连接示例(主机模式) + + .. note:: + 此原理图为简化示例,用于演示外部 PHY 连接方式,未包含完整 {IDF_TARGET_NAME} 设计所需的所有元器件和信号(如 VCC、GND、RESET 等)。 + 图中包含 +5 V 电源轨(用于为 USB 设备供电)和 VCC 电源轨(通常为 3.3 V)。VCC 电压应与芯片供电电压保持一致。确保为 USB 总线提供的 +5 V 电源可靠,并具备必要的保护措施(如电源开关和限流设计)在支持 USB 总线供电设备时,务必遵守 USB 主机的供电规范。 + + 硬件配置通过将 GPIO 映射到 PHY 引脚实现。任何未使用的引脚(如 :cpp:member:`usb_phy_ext_io_conf_t::suspend_n_io_num`) **必须设置为 -1**。 + + .. note:: + :cpp:member:`usb_phy_ext_io_conf_t::suspend_n_io_num` 引脚 **当前不支持**,无需连接。 + + **示例代码:** + + .. code-block:: c + + // 外部 PHY 的 GPIO 配置 + const usb_phy_ext_io_conf_t ext_io_conf = { + .vp_io_num = 8, + .vm_io_num = 5, + .rcv_io_num = 11, + .oen_io_num = 17, + .vpo_io_num = 4, + .vmo_io_num = 46, + .fs_edge_sel_io_num = 38, + .suspend_n_io_num = -1, + }; + + // 针对 OTG 控制器(Host 模式)的外部 PHY 配置与初始化 + const usb_phy_config_t phy_config = { + .controller = USB_PHY_CTRL_OTG, + .target = USB_PHY_TARGET_EXT, + .otg_mode = USB_OTG_MODE_HOST, + .otg_speed = USB_PHY_SPEED_FULL, + .ext_io_conf = &ext_io_conf + }; + + usb_phy_handle_t phy_hdl; + ESP_ERROR_CHECK(usb_new_phy(&phy_config, &phy_hdl)); + + // 配置 USB 主机使用外部初始化的 PHY + usb_host_config_t host_config = { + .skip_phy_setup = true, + // 根据需求添加其他 host 配置字段 + }; + ESP_ERROR_CHECK(usb_host_install(&host_config)); + + 该配置确保 USB 主机协议栈使用 **外部 PHY**,并跳过 PHY 初始化步骤。 + 主机栈配置 ----------