refactor(ext_port): Removed ext_hub dependency

components/usb/private_include/ext_port.h

@@ -7,15 +7,38 @@
 
 #include <stdint.h>
 #include "esp_err.h"
-#include "ext_hub.h"
 #include "usb/usb_types_stack.h"
+#include "sdkconfig.h"
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
+#if CONFIG_USB_HOST_HUB_MULTI_LEVEL
+#define ENABLE_MULTIPLE_HUBS             1
+#endif // CONFIG_USB_HOST_HUB_MULTI_LEVEL
+
 typedef struct ext_port_s  *ext_port_hdl_t;
 
+// ------------------------ External Port API typedefs -------------------------
+
+/**
+ * @brief External Hub Port driver
+ */
+typedef struct {
+    esp_err_t (*new)(void *port_cfg, void **port_hdl);
+    esp_err_t (*reset)(void *port_hdl);
+    esp_err_t (*recycle)(void *port_hdl);
+    esp_err_t (*active)(void *port_hdl);
+    esp_err_t (*disable)(void *port_hdl);
+    esp_err_t (*gone)(void *port_hdl);
+    esp_err_t (*del)(void *port_hdl);
+    esp_err_t (*get_speed)(void *por_hdl, usb_speed_t *speed);
+    esp_err_t (*get_status)(void *port_hdl);
+    esp_err_t (*set_status)(void *port_hdl, const usb_port_status_t *status);
+    esp_err_t (*req_process)(void *port_hdl);
+} ext_port_driver_api_t;
+
 // ------------------------------ Events ---------------------------------------
 typedef enum {
     EXT_PORT_CONNECTED = 0x01,      /**< Port has a device connection event */
@@ -30,7 +53,6 @@ typedef struct {
     ext_port_event_t event;
     union {
         struct {
-            ext_hub_handle_t ext_hub_hdl;       /**< Ports' parent external Hub handle */
             usb_device_handle_t parent_dev_hdl; /**< Ports' parent device handle */
             uint8_t parent_port_num;            /**< Ports' parent port number */
         } connected;                            /**< EXT_PORT_CONNECTED event specific data */
@@ -47,6 +69,24 @@ typedef struct {
     };
 } ext_port_event_data_t;
 
+typedef enum {
+    EXT_PORT_PARENT_REQ_CONTROL = 0x01,     /** Port requires action from the parent Hub */
+    EXT_PORT_PARENT_REQ_PROC_COMPLETED      /** All ports were handled */
+} ext_port_parent_request_type_t;
+
+/**
+ * @brief Specific data for External Port parent Hub class specific request
+ */
+typedef struct {
+    ext_port_parent_request_type_t type;
+    union {
+        struct {
+            usb_hub_class_request_t req;
+            uint8_t feature;
+        } control;
+    };
+} ext_port_parent_request_data_t;
+
 // ------------------------------ Callbacks ------------------------------------
 /**
  * @brief Callback used to indicate that the External Port Driver requires process callback
@@ -60,7 +100,12 @@ typedef void (*ext_port_cb_t)(void *user_arg);
  *
  * @note For the Hub Driver only
  */
-typedef void (*ext_port_event_cb_t)(ext_port_event_data_t *event_data, void *arg);
+typedef void (*ext_port_event_cb_t)(ext_port_hdl_t port_hdl, ext_port_event_data_t *event_data, void *arg);
+
+/**
+ * @brief Callback used to indicate that the External Port driver requires a Hub class specific request
+ */
+typedef esp_err_t (*ext_port_parent_request_cb_t)(ext_port_hdl_t port_hdl, ext_port_parent_request_data_t *data, void *user_arg);
 
 // ----------------- External Port Driver configuration ------------------------
 
@@ -72,7 +117,7 @@ typedef struct {
     void *proc_req_cb_arg;                      /**< External Port process callback argument */
     ext_port_event_cb_t event_cb;               /**< External Port event callback */
     void *event_cb_arg;                         /**< External Port event callback argument */
-    ext_hub_request_cb_t hub_request_cb;        /**< External Port Hub request callback */
+    ext_port_parent_request_cb_t hub_request_cb;/**< External Port Hub request callback */
     void *hub_request_cb_arg;                   /**< External Port Hub request callback argument */
 } ext_port_driver_config_t;
 
@@ -82,7 +127,7 @@ typedef struct {
  * Structure is used to create new port
  */
 typedef struct {
-    ext_hub_handle_t ext_hub_hdl;               /**< Ports' parent external Hub handle */
+    void* context;                              /**< Ports' parent external Hub handle */
     usb_device_handle_t parent_dev_hdl;         /**< Ports' parent device handle */
     uint8_t parent_port_num;                    /**< Ports' parent port number */
     uint16_t port_power_delay_ms;               /**< Ports' Power on time to Power Good, ms */
@@ -138,7 +183,28 @@ esp_err_t ext_port_process(void);
  *    - NULL:                       The Driver has not been installed
  *    - not NULL:                   Pointer to the External Port Driver API
  */
-const ext_hub_port_driver_t *ext_port_get_driver(void);
+const ext_port_driver_api_t *ext_port_get_driver(void);
+
+/**
+ * @brief Returns External Port Driver's context
+ *
+ * @param[in] port_hdl Port object handle
+ * @return
+ *   - Pointer to the External Port Driver context
+ */
+void* ext_port_get_context(ext_port_hdl_t port_hdl);
+
+/**
+ * @brief Returns External Port's port number
+ *
+ * @param[in] port_hdl Port object handle
+ * @param[out] port1 Port number, starting from 1
+ * @return
+ *    - ESP_ERR_NOT_ALLOWED if the External Port Driver has not been installed
+ *    - ESP_ERR_INVALID_ARG if the Port handle is NULL
+ *    - ESP_OK if the port number was successfully returned
+ */
+esp_err_t ext_port_get_port_num(ext_port_hdl_t port_hdl, uint8_t *port1);
 
 #ifdef __cplusplus
 }