The UHC provides a high-level abstraction of the usb host.
You can use these functions to control the main host state (start/suspend/resume/...).
The following USB host configuration must be included in the conf_usb_host.h file of the application.
USB_HOST_UHI (List of UHI APIs)
Define the list of UHI supported by USB host. (Ex.: UHI_MSC,UHI_HID_MOUSE).
USB_HOST_POWER_MAX (mA)
Maximum current allowed on Vbus.
USB_HOST_HS_SUPPORT (Only defined)
Authorize the USB host to run in High Speed.
USB_HOST_HUB_SUPPORT (Only defined)
Authorize the USB HUB support.
The following optional USB host callback can be defined in the conf_usb_host.h file of the application.
void UHC_MODE_CHANGE(bool b_host_mode)
To notify that the USB mode are switched automatically. This is possible only when ID pin is available.
void UHC_VBUS_CHANGE(bool b_present)
To notify that the Vbus level has changed (Available only in USB hardware with Vbus monitoring).
void UHC_VBUS_ERROR(void)
To notify that a Vbus error has occurred (Available only in USB hardware with Vbus monitoring).
void UHC_CONNECTION_EVENT(uhc_device_t* dev,bool b_present)
To notify that a device has been connected or disconnected.
void UHC_WAKEUP_EVENT(void)
Called when a USB device or the host have wake up the USB line.
void UHC_SOF_EVENT(void)
Called for each received SOF each 1 ms. Available in High and Full speed mode.
uint8_t UHC_DEVICE_CONF(uhc_device_t* dev)
Called when a USB device configuration must be chosen. Thus, the application can choose either a configuration number for this device or a configuration number 0 to reject it. If callback not defined the configuration 1 is chosen.
void UHC_ENUM_EVENT(uhc_device_t* dev, uint8_t b_status)
Called when a USB device enumeration is completed or fail.
Modules | |
Implementation of UHC | |
Internal implementation. | |
USB Host Controller (UHC) - Prerequisites | |
Common prerequisites for all USB hosts. | |
USB Host Controller (UHC) - Example code | |
Common example code for all USB hosts. | |
USB Device Controller (UHC) - Workflow | |
Common workflow for all USB devices. | |
Data Structures | |
struct | uhc_device_t |
Structure to store device information. More... | |
Macros | |
#define | UHC_BSS(x) COMPILER_ALIGNED(x) |
#define | UHC_DATA(x) COMPILER_ALIGNED(x) |
Enumerations | |
enum | uhc_enum_status_t { UHC_ENUM_SUCCESS = 0, UHC_ENUM_UNSUPPORTED, UHC_ENUM_OVERCURRENT, UHC_ENUM_FAIL, UHC_ENUM_HARDWARE_LIMIT, UHC_ENUM_SOFTWARE_LIMIT, UHC_ENUM_MEMORY_LIMIT, UHC_ENUM_DISCONNECT } |
Enumeration status Used in UHC_ENUM_EVENT() callback when a USB device enumeration is completed. More... | |
Functions to control the USB host stack | |
void | uhc_start (void) |
Starts the host mode. More... | |
void | uhc_stop (bool b_id_stop) |
Stops the host mode. More... | |
void | uhc_suspend (bool b_remotewakeup) |
Suspends a USB line. More... | |
bool | uhc_is_suspend (void) |
Test if the suspend state is enabled on the USB line. More... | |
void | uhc_resume (void) |
Resumes the USB line. More... | |
User functions to manage a device | |
uint8_t | uhc_get_device_number (void) |
Returns the number of connected devices. More... | |
char * | uhc_dev_get_string_manufacturer (uhc_device_t *dev) |
Gets the USB string manufacturer from a USB device. More... | |
char * | uhc_dev_get_string_product (uhc_device_t *dev) |
Gets the USB string product from a USB device. More... | |
char * | uhc_dev_get_string_serial (uhc_device_t *dev) |
Gets the USB string serial from a USB device. More... | |
char * | uhc_dev_get_string (uhc_device_t *dev, uint8_t str_id) |
Gets a USB string from a USB device. More... | |
uint16_t | uhc_dev_get_power (uhc_device_t *dev) |
Gets the maximum consumption of a device (mA) More... | |
uhd_speed_t | uhc_dev_get_speed (uhc_device_t *dev) |
Returns the current device speed. More... | |
bool | uhc_dev_is_high_speed_support (uhc_device_t *dev) |
Tests if the device supports the USB high speed This function can wait the end of a setup request and the timing can be long (1ms to 5s). More... | |
void | uhc_dev_reset (uhc_device_t *dev) |
Reset to re-enumerate. More... | |
#define UHC_BSS | ( | x | ) | COMPILER_ALIGNED(x) |
#define UHC_DATA | ( | x | ) | COMPILER_ALIGNED(x) |
enum uhc_enum_status_t |
Enumeration status Used in UHC_ENUM_EVENT() callback when a USB device enumeration is completed.
uint16_t uhc_dev_get_power | ( | uhc_device_t * | dev | ) |
Gets the maximum consumption of a device (mA)
dev | Device to request |
References usb_conf_desc_t::bMaxPower, uhc_device_t::conf_desc, and NULL.
uhd_speed_t uhc_dev_get_speed | ( | uhc_device_t * | dev | ) |
Returns the current device speed.
dev | Device to request |
References uhc_device_t::speed.
char* uhc_dev_get_string | ( | uhc_device_t * | dev, |
uint8_t | str_id | ||
) |
Gets a USB string from a USB device.
This function waits the end of setup requests and the timing can be long (3ms to 15s). Thus, do not call it in an interrupt routine. This function allocates a buffer which must be free by user application.
dev | Device to request |
str_id | String ID requested |
References usb_str_desc_t::bLength, usb_setup_req_t::bmRequestType, usb_setup_req_t::bRequest, le16_to_cpu, NULL, usb_str_lgid_desc_t::string, uhc_setup_request_callback(), uhc_setup_request_finish, uhc_setup_request_finish_status, uhd_setup_request(), UNUSED, USB_DT_STRING, USB_REQ_DIR_IN, USB_REQ_GET_DESCRIPTOR, USB_REQ_RECIP_DEVICE, USB_REQ_TYPE_STANDARD, usb_setup_req_t::wIndex, usb_setup_req_t::wLength, and usb_setup_req_t::wValue.
Referenced by uhc_dev_get_string_manufacturer(), uhc_dev_get_string_product(), and uhc_dev_get_string_serial().
char* uhc_dev_get_string_manufacturer | ( | uhc_device_t * | dev | ) |
Gets the USB string manufacturer from a USB device.
This function waits the end of setup requests and the timing can be long (3ms to 15s). Thus, do not call it in an interrupt routine. This function allocates a buffer which must be free by user application.
dev | Device to request |
References uhc_device_t::dev_desc, usb_dev_desc_t::iManufacturer, NULL, and uhc_dev_get_string().
char* uhc_dev_get_string_product | ( | uhc_device_t * | dev | ) |
Gets the USB string product from a USB device.
This function waits the end of setup requests and the timing can be long (3ms to 15s). Thus, do not call it in an interrupt routine. This function allocates a buffer which must be free by user application.
dev | Device to request |
References uhc_device_t::dev_desc, usb_dev_desc_t::iProduct, NULL, and uhc_dev_get_string().
char* uhc_dev_get_string_serial | ( | uhc_device_t * | dev | ) |
Gets the USB string serial from a USB device.
This function waits the end of setup requests and the timing can be long (3ms to 15s). Thus, do not call it in an interrupt routine. This function allocates a buffer which must be free by user application.
dev | Device to request |
References uhc_device_t::dev_desc, usb_dev_desc_t::iSerialNumber, NULL, and uhc_dev_get_string().
bool uhc_dev_is_high_speed_support | ( | uhc_device_t * | dev | ) |
Tests if the device supports the USB high speed This function can wait the end of a setup request and the timing can be long (1ms to 5s).
Thus, do not call it in an interrupt routine.
dev | Device to request |
References usb_setup_req_t::bmRequestType, usb_setup_req_t::bRequest, NULL, uhc_device_t::speed, uhc_setup_request_callback(), uhc_setup_request_finish, uhc_setup_request_finish_status, uhd_setup_request(), UHD_SPEED_FULL, UHD_SPEED_HIGH, USB_DT_DEVICE_QUALIFIER, USB_REQ_DIR_IN, USB_REQ_GET_DESCRIPTOR, USB_REQ_RECIP_DEVICE, USB_REQ_TYPE_STANDARD, usb_setup_req_t::wIndex, usb_setup_req_t::wLength, and usb_setup_req_t::wValue.
void uhc_dev_reset | ( | uhc_device_t * | dev | ) |
Reset to re-enumerate.
dev | Device to request |
References uhc_device_t::conf_desc, dev, NULL, uhc_enum_try, uhc_enumeration_step3(), UHC_NB_UHI, and uhi_api_t::uninstall.
uint8_t uhc_get_device_number | ( | void | ) |
Returns the number of connected devices.
References uhc_device_t::address, dev, g_uhc_device_root, NULL, and UHC_USB_ADD_NOT_VALID.
bool uhc_is_suspend | ( | void | ) |
Test if the suspend state is enabled on the USB line.
References uhc_device_t::address, UHC_USB_ADD_NOT_VALID, and uhd_is_suspend().
Referenced by uhc_resume().
void uhc_resume | ( | void | ) |
Resumes the USB line.
References uhc_is_suspend(), and uhd_resume().
void uhc_start | ( | void | ) |
Starts the host mode.
References uhc_device_t::address, uhc_sof_timeout, UHC_USB_ADD_NOT_VALID, and uhd_enable().
Referenced by main(), otg_dual_enable(), and otg_id_handler().
void uhc_stop | ( | bool | b_id_stop | ) |
Stops the host mode.
b_id_stop | Stop USB ID pin management, if true. |
References uhd_disable().
Referenced by otg_id_handler().
void uhc_suspend | ( | bool | b_remotewakeup | ) |
Suspends a USB line.
b_remotewakeup | Authorize the remote wakeup features, if true |
References uhc_enum_try, uhc_remotewakeup(), and uhd_suspend().