feat(hub): Added support for multiple root ports

This will allow having both FS and HS root ports active at the same time
and connected devices working properly.

Author: tore-espressif

host/usb/private_include/ext_hub.h

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -97,6 +97,15 @@ void *ext_hub_get_client(void);
  */
 esp_err_t ext_hub_get_speed(ext_hub_handle_t ext_hub_hdl, usb_speed_t *speed);
 
+/**
+ * @brief Get the root port handle of an External Hub device
+ *
+ * @param[in] ext_hub_hdl External Hub device handle
+ *
+ * @return Root port handle on success, NULL on error
+ */
+hcd_port_handle_t ext_hub_get_root_port(ext_hub_handle_t ext_hub_hdl);
+
 /**
  * @brief Add new device
  *

host/usb/private_include/hcd.h

@@ -14,12 +14,17 @@ extern "C" {
 #include <stdbool.h>
 #include <sys/queue.h>
 #include "esp_err.h"
+#include "soc/soc_caps.h"
 #include "esp_idf_version.h"
 #include "usb_private.h"
 #include "usb/usb_types_ch9.h"
 
 // ------------------------------------------------- Macros & Types ----------------------------------------------------
 
+// ----------------------- Configs -------------------------
+
+#define HCD_NUM_PORTS                           SOC_USB_OTG_PERIPH_NUM   // Each peripheral is a root port
+
 // --------------------- IDF Versioning compatibility -------------------------
 
 // Remote wakeup HAL changes are present
@@ -315,6 +320,8 @@ esp_err_t hcd_port_recover(hcd_port_handle_t port_hdl);
 /**
  * @brief Get the context variable of a port
  *
+ * @note Used only in tests
+ *
  * @param[in] port_hdl Port handle
  *
  * @return

host/usb/private_include/usbh.h

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2015-2025 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2015-2026 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -395,6 +395,18 @@ esp_err_t usbh_dev_get_addr(usb_device_handle_t dev_hdl, uint8_t *dev_addr);
  */
 esp_err_t usbh_dev_get_info(usb_device_handle_t dev_hdl, usb_device_info_t *dev_info);
 
+/**
+ * @brief Get the root port handle of a device
+ *
+ * @param[in] dev_hdl Device handle
+ * @param[out] root_port_hdl Root port handle
+ *
+ * @return
+ *    - ESP_OK: Root port handle obtained successfully
+ *    - ESP_ERR_INVALID_ARG: Invalid argument
+ */
+esp_err_t usbh_dev_get_root_port_hdl(usb_device_handle_t dev_hdl, hcd_port_handle_t *root_port_hdl);
+
 /**
  * @brief Get a device's device descriptor
  *

host/usb/src/ext_hub.c

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -1298,6 +1298,18 @@ esp_err_t ext_hub_get_speed(ext_hub_handle_t ext_hub_hdl, usb_speed_t *speed)
     return ESP_OK;
 }
 
+hcd_port_handle_t ext_hub_get_root_port(ext_hub_handle_t ext_hub_hdl)
+{
+    EXT_HUB_CHECK(ext_hub_hdl != NULL, NULL);
+    EXT_HUB_CHECK(dev_is_in_list(ext_hub_hdl), NULL);
+    ext_hub_dev_t *ext_hub_dev = (ext_hub_dev_t *)ext_hub_hdl;
+    hcd_port_handle_t root_port_hdl = NULL;
+    if (usbh_dev_get_root_port_hdl(ext_hub_dev->constant.dev_hdl, &root_port_hdl) != ESP_OK) {
+        return NULL;
+    }
+    return root_port_hdl;
+}
+
 esp_err_t ext_hub_new_dev(uint8_t dev_addr)
 {
     EXT_HUB_ENTER_CRITICAL();

host/usb/src/hcd_dwc.c

@@ -17,7 +17,6 @@
 #include "esp_err.h"
 #include "esp_log.h"
 
-#include "soc/soc_caps.h"
 #include "hal/usb_dwc_hal.h"
 #include "hcd.h"
 #include "usb_private.h"
@@ -51,8 +50,6 @@
 #define CTRL_EP_MAX_MPS_LS                      8   // Largest Maximum Packet Size for Low Speed control endpoints
 #define CTRL_EP_MAX_MPS_HSFS                    64  // Largest Maximum Packet Size for High & Full Speed control endpoints
 
-#define NUM_PORTS                               SOC_USB_OTG_PERIPH_NUM   // Each peripheral is a root port
-
 // ----------------------- Configs -------------------------
 
 #ifdef CONFIG_USB_HOST_DWC_DMA_CAP_MEMORY_IN_PSRAM      // In esp32p4, the USB-DWC internal DMA can access external RAM
@@ -269,7 +266,7 @@ struct port_obj {
 
 // With s_port_inited[] we can check if a port has been initialized -> to provide singleton handle for each root port
 // Each peripheral is a root port
-static bool s_port_inited[NUM_PORTS] = {0};
+static bool s_port_inited[HCD_NUM_PORTS] = {0};
 
 // ------------------------------------------------- Forward Declare ---------------------------------------------------
 
@@ -1447,7 +1444,7 @@ static esp_err_t _port_cmd_disable(port_t *port)
 esp_err_t hcd_port_init(int port_number, const hcd_port_config_t *port_config, hcd_port_handle_t *port_hdl)
 {
     HCD_CHECK(port_number >= 0 && port_config != NULL && port_hdl != NULL, ESP_ERR_INVALID_ARG);
-    HCD_CHECK(port_number < NUM_PORTS, ESP_ERR_NOT_FOUND);
+    HCD_CHECK(port_number < HCD_NUM_PORTS, ESP_ERR_NOT_FOUND);
 
     HCD_ENTER_CRITICAL();
     HCD_CHECK_FROM_CRIT(!s_port_inited[port_number], ESP_ERR_INVALID_STATE);