Allow retrieving the port a device is connected to

src/host/usbh.c

@@ -327,6 +327,15 @@ bool tuh_rhport_reset_bus(uint8_t rhport, bool active) {
   return true;
 }
 
+void tuh_devtree_get_info(uint8_t dev_addr, tuh_devtree_info_t* devtree_info) {
+  hcd_devtree_info_t dt;
+  hcd_devtree_get_info(dev_addr, &dt);
+  devtree_info->rhport   = dt.rhport;
+  devtree_info->hub_addr = dt.hub_addr;
+  devtree_info->hub_port = dt.hub_port;
+  devtree_info->speed    = dt.speed;
+}
+
 //--------------------------------------------------------------------+
 // PUBLIC API (Parameter Verification is required)
 //--------------------------------------------------------------------+

src/host/usbh.h

@@ -78,6 +78,15 @@ enum {
   TUH_CFGID_RPI_PIO_USB_CONFIGURATION = OPT_MCU_RP2040 << 8 // cfg_param: pio_usb_configuration_t
 };
 
+// Return data for tuh_devtree_get_info()
+typedef struct
+{
+  uint8_t rhport;
+  uint8_t hub_addr;
+  uint8_t hub_port;
+  uint8_t speed;
+} tuh_devtree_info_t;
+
 //--------------------------------------------------------------------+
 // APPLICATION CALLBACK
 //--------------------------------------------------------------------+
@@ -148,6 +157,9 @@ bool tuh_rhport_is_active(uint8_t rhport);
 // Assert/de-assert Bus Reset signal to roothub port. USB specs: it should last 10-50ms
 bool tuh_rhport_reset_bus(uint8_t rhport, bool active);
 
+// Retrieve devtree info like port of hub a device is connected to and speed.
+void tuh_devtree_get_info(uint8_t dev_addr, tuh_devtree_info_t* devtree_info);
+
 //--------------------------------------------------------------------+
 // Device API
 //--------------------------------------------------------------------+