From 10252a8fb776f2f01001ce5d8f52d1e0af5386f2 Mon Sep 17 00:00:00 2001 From: "igor.masar" Date: Thu, 17 Jul 2025 21:41:54 +0200 Subject: [PATCH] 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 ------------------------