From 8b2b2729bbad9998ead43c21bcc60b2001a197fb Mon Sep 17 00:00:00 2001 From: renpeiying Date: Tue, 12 Aug 2025 15:01:56 +0800 Subject: [PATCH] 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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 z 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 CCN&`d 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 初始化步骤。 + 主机栈配置 ----------