mirror of
https://github.com/espressif/esp-idf.git
synced 2025-08-11 21:10:20 +00:00
feat(ext_hub): Added External Hub driver
This commit is contained in:
Roman Leonov
248
components/usb/private_include/ext_hub.h
Normal file
248
components/usb/private_include/ext_hub.h
Normal file
@@ -0,0 +1,248 @@
|
||||
/*
|
||||
* SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*/
|
||||
#pragma once
|
||||
|
||||
#include <stdint.h>
|
||||
#include "sdkconfig.h"
|
||||
#include "esp_err.h"
|
||||
#include "hcd.h"
|
||||
#include "usbh.h"
|
||||
#include "usb/usb_types_stack.h"
|
||||
#include "usb/usb_types_ch9.h"
|
||||
#include "usb/usb_types_ch11.h"
|
||||
|
||||
#if CONFIG_USB_HOST_HUB_MULTI_LEVEL
|
||||
#define ENABLE_MULTIPLE_HUBS 1
|
||||
#endif // CONFIG_USB_HOST_HUB_MULTI_LEVEL
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
// ----------------------------- Handles ---------------------------------------
|
||||
|
||||
typedef struct ext_hub_s *ext_hub_handle_t;
|
||||
|
||||
// ---------------------------- Callbacks --------------------------------------
|
||||
|
||||
/**
|
||||
* @brief Callback used to indicate that the External Hub Driver requires process callback
|
||||
* For Hub Driver only
|
||||
*/
|
||||
typedef bool (*ext_hub_cb_t)(bool in_isr, void *user_arg);
|
||||
|
||||
// ------------------------ 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 (*free)(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);
|
||||
} ext_hub_port_driver_t;
|
||||
|
||||
/**
|
||||
* @brief External Hub Driver configuration
|
||||
*/
|
||||
typedef struct {
|
||||
ext_hub_cb_t proc_req_cb; /**< External Hub process callback */
|
||||
void *proc_req_cb_arg; /**< External Hub process callback argument */
|
||||
const ext_hub_port_driver_t* port_driver; /**< External Port Driver */
|
||||
} ext_hub_config_t;
|
||||
|
||||
// ------------------------------ Driver ---------------------------------------
|
||||
|
||||
/**
|
||||
* @brief Install External Hub Driver
|
||||
*
|
||||
* Entry:
|
||||
* - should be called within Hub Driver
|
||||
*
|
||||
* @param[in] config External Hub driver configuration
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_install(const ext_hub_config_t* config);
|
||||
|
||||
/**
|
||||
* @brief Uninstall External Hub Driver
|
||||
*
|
||||
* Entry:
|
||||
* - should be called within Hub Driver
|
||||
*
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_uninstall(void);
|
||||
|
||||
/**
|
||||
* @brief External Hub Driver get client pointer
|
||||
*
|
||||
* Entry:
|
||||
* - should be called within Hub Driver
|
||||
*
|
||||
* @param[in] config External Hub driver configuration
|
||||
* @return Unique pointer to identify the External Hub as a USB Host client
|
||||
*/
|
||||
void *ext_hub_get_client(void);
|
||||
|
||||
// -------------------------- External Hub API ---------------------------------
|
||||
|
||||
/**
|
||||
* @brief Get External Hub device handle by USBH device handle
|
||||
*
|
||||
* @param[in] dev_hdl USBH device handle
|
||||
* @param[out] ext_hub_hdl External Hub device handle
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_get_handle(usb_device_handle_t dev_hdl, ext_hub_handle_t *ext_hub_hdl);
|
||||
|
||||
/**
|
||||
* @brief Add new device
|
||||
*
|
||||
* After attaching new device:
|
||||
* - configure it's parameters (requesting hub descriptor)
|
||||
*
|
||||
* @param[in] dev_addr Device bus address
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_new_dev(uint8_t dev_addr);
|
||||
|
||||
/**
|
||||
* @brief Device gone
|
||||
*
|
||||
* After device were detached:
|
||||
* - prepare the device to be freed
|
||||
*
|
||||
* @param[in] dev_addr Device bus address
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_dev_gone(uint8_t dev_addr);
|
||||
|
||||
/**
|
||||
* @brief Marks all devices to be freed
|
||||
*
|
||||
* Entry:
|
||||
* - should be called within Hub Driver when USB Host library need to be uninstalled
|
||||
*
|
||||
* @param[in] dev_addr Device bus address
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_all_free(void);
|
||||
|
||||
/**
|
||||
* @brief The External Hub or Ports statuses change completed
|
||||
*
|
||||
* Enables Interrupt IN endpoint to get information about Hub or Ports statuses change
|
||||
*
|
||||
* @param[in] ext_hub_hdl External Hub device handle
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_status_handle_complete(ext_hub_handle_t ext_hub_hdl);
|
||||
|
||||
/**
|
||||
* @brief External Hub driver's process function
|
||||
*
|
||||
* External Hub driver process function that must be called repeatedly to process the driver's actions and events.
|
||||
* If blocking, the caller can block on the notification callback of source USB_PROC_REQ_SOURCE_HUB
|
||||
* to run this function.
|
||||
*/
|
||||
esp_err_t ext_hub_process(void);
|
||||
|
||||
// -------------------- External Hub - Port related ----------------------------
|
||||
|
||||
/**
|
||||
* @brief Indicate to the External Hub driver that a device's port can be recycled
|
||||
*
|
||||
* The device connected to the port has been freed. The Hub driver can now
|
||||
* recycle the port.
|
||||
*
|
||||
* @param[in] ext_hub_hdl External Hub handle
|
||||
* @param[in] port_num Port number
|
||||
* @retval ESP_OK: Success
|
||||
*/
|
||||
esp_err_t ext_hub_port_recycle(ext_hub_handle_t ext_hub_hdl, uint8_t port_num);
|
||||
|
||||
/**
|
||||
* @brief Indicate to the External Hub driver that a device's port need a reset
|
||||
*
|
||||
* @param[in] ext_hub_hdl External Hub handle
|
||||
* @param[in] port_num Port number
|
||||
* @retval ESP_OK: Success
|
||||
*/
|
||||
esp_err_t ext_hub_port_reset(ext_hub_handle_t ext_hub_hdl, uint8_t port_num);
|
||||
|
||||
/**
|
||||
* @brief Indicate to the External Hub driver that a device's port has a device and device has been enumerated
|
||||
*
|
||||
* @param[in] ext_hub_hdl External Hub handle
|
||||
* @param[in] port_num Port number
|
||||
* @retval ESP_OK: Success
|
||||
*/
|
||||
esp_err_t ext_hub_port_active(ext_hub_handle_t ext_hub_hdl, uint8_t port_num);
|
||||
|
||||
/**
|
||||
* @brief Indicate to the External Hub driver that a device's port should be disabled
|
||||
*
|
||||
* @param[in] ext_hub_hdl External Hub handle
|
||||
* @param[in] port_num Port number
|
||||
* @retval ESP_OK: Success
|
||||
*/
|
||||
esp_err_t ext_hub_port_disable(ext_hub_handle_t ext_hub_hdl, uint8_t port_num);
|
||||
|
||||
/**
|
||||
* @brief Returns device speed of the device, attached to the port
|
||||
*
|
||||
* @param[in] ext_hub_hdl External Hub handle
|
||||
* @param[in] port_num Port number
|
||||
* @param[out] speed Devices' speed
|
||||
* @retval ESP_OK: Success
|
||||
*/
|
||||
esp_err_t ext_hub_port_get_speed(ext_hub_handle_t ext_hub_hdl, uint8_t port_num, usb_speed_t *speed);
|
||||
|
||||
// --------------------------- USB Chapter 11 ----------------------------------
|
||||
|
||||
/**
|
||||
* @brief Set Port Feature request
|
||||
*
|
||||
* @param[in] ext_hub_hdl External Hub device handle
|
||||
* @param[in] port_num Port number
|
||||
* @param[in] feature Port Feature to set
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_set_port_feature(ext_hub_handle_t ext_hub_hdl, uint8_t port_num, uint8_t feature);
|
||||
|
||||
/**
|
||||
* @brief Clear Port Feature request
|
||||
*
|
||||
* @param[in] ext_hub_hdl External Hub device handle
|
||||
* @param[in] port_num Port number
|
||||
* @param[in] feature Port Feature to clear
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_clear_port_feature(ext_hub_handle_t ext_hub_hdl, uint8_t port_num, uint8_t feature);
|
||||
|
||||
/**
|
||||
* @brief Get Port Status request
|
||||
*
|
||||
* Sends the request to retrieve port status data.
|
||||
* Actual port status data could be requested by calling ext_hub_get_port_status() after request completion.
|
||||
*
|
||||
* @param[in] ext_hub_hdl External Hub device handle
|
||||
* @param[in] port_num Port number
|
||||
* @return esp_err_t
|
||||
*/
|
||||
esp_err_t ext_hub_get_port_status(ext_hub_handle_t ext_hub_hdl, uint8_t port_num);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
Reference in New Issue
Block a user