75 lines
3.4 KiB
C
75 lines
3.4 KiB
C
|
/*!
|
||
|
|
\file usbh_std.h
|
||
|
|
\brief header file for usbh_std.c
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
Copyright (C) 2017 GigaDevice
|
||
|
|
|
||
|
|
2017-02-10, V1.0.0, firmware for GD32F30x
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef USBH_STD_H
|
||
|
|
#define USBH_STD_H
|
||
|
|
|
||
|
|
#include "usbh_core.h"
|
||
|
|
#include "usbh_usr.h"
|
||
|
|
|
||
|
|
/* standard feature selector for clear feature command */
|
||
|
|
#define FEATURE_SELECTOR_ENDPOINT 0x00U
|
||
|
|
#define FEATURE_SELECTOR_DEVICE 0x01U
|
||
|
|
|
||
|
|
#define USBH_SETUP_PACKET_SIZE 8U /* setup packet size */
|
||
|
|
#define ENUM_HANDLE_TABLE_SIZE 10U /* enumerate handle table size */
|
||
|
|
|
||
|
|
extern uint8_t usbh_cfg_desc[512];
|
||
|
|
extern uint8_t enum_polling_handle_flag;
|
||
|
|
extern state_table_struct enum_handle_table[ENUM_HANDLE_TABLE_SIZE];
|
||
|
|
|
||
|
|
typedef enum
|
||
|
|
{
|
||
|
|
ENUN_EVENT_IDLE = 0, /* the enum idle event */
|
||
|
|
ENUM_EVENT_SET_ADDR, /* the enum set address event */
|
||
|
|
ENUN_EVENT_GET_FULL_DEV_DESC, /* the enum get full device descripter event */
|
||
|
|
ENUN_EVENT_GET_CFG_DESC, /* the enum get congiguration descripter event */
|
||
|
|
ENUN_EVENT_GET_FULL_CFG_DESC, /* the enum get full configuration descripter event */
|
||
|
|
ENUN_EVENT_GET_MFC_STRING_DESC, /* the enum get MFC string descripter event */
|
||
|
|
ENUN_EVENT_GET_PRODUCT_STRING_DESC, /* the enum get product string event */
|
||
|
|
ENUN_EVENT_GET_SERIALNUM_STRING_DESC, /* the enum get serialnum string event */
|
||
|
|
ENUN_EVENT_SET_CONFIGURATION, /* the enum set configuration event */
|
||
|
|
ENUN_EVENT_DEV_CONFIGURED /* the enum device configured event */
|
||
|
|
}enum_event_enum;
|
||
|
|
|
||
|
|
/* function declarations */
|
||
|
|
/* the polling function of enumeration state */
|
||
|
|
usbh_status_enum enum_state_polling_fun (usb_core_handle_struct *pudev, usbh_host_struct *puhost, void *pustate);
|
||
|
|
/* get descriptor in usb host enumeration stage */
|
||
|
|
void usbh_enum_desc_get (usb_core_handle_struct *pudev,
|
||
|
|
usbh_host_struct *puhost,
|
||
|
|
uint8_t *buf,
|
||
|
|
uint8_t req_type,
|
||
|
|
uint16_t value_idx,
|
||
|
|
uint16_t len);
|
||
|
|
/* set address in usb host enumeration stage */
|
||
|
|
void usbh_enum_addr_set (usb_core_handle_struct *pudev, usbh_host_struct *puhost, uint8_t device_address);
|
||
|
|
/* set configuration in usb host enumeration stage */
|
||
|
|
void usbh_enum_cfg_set (usb_core_handle_struct *pudev, usbh_host_struct *puhost, uint16_t cfg_idx);
|
||
|
|
/* parse the device descriptor */
|
||
|
|
void usbh_device_desc_parse (usb_descriptor_device_struct *dev_desc, uint8_t *buf, uint16_t len);
|
||
|
|
/* parse the configuration descriptor */
|
||
|
|
void usbh_cfg_desc_parse (usb_descriptor_configuration_struct *cfg_desc,
|
||
|
|
usb_descriptor_interface_struct *itf_desc,
|
||
|
|
usb_descriptor_endpoint_struct ep_desc[][USBH_MAX_EP_NUM],
|
||
|
|
uint8_t *buf,
|
||
|
|
uint16_t len);
|
||
|
|
/* parse the interface descriptor */
|
||
|
|
void usbh_interface_desc_parse (usb_descriptor_interface_struct *itf_desc, uint8_t *buf);
|
||
|
|
/* parse the endpoint descriptor */
|
||
|
|
void usbh_endpoint_desc_parse (usb_descriptor_endpoint_struct *ep_desc, uint8_t *buf);
|
||
|
|
/* parse the string descriptor */
|
||
|
|
void usbh_string_desc_parse (uint8_t *psrc, uint8_t *pdest, uint16_t len);
|
||
|
|
/* get the next descriptor header */
|
||
|
|
usb_descriptor_header_struct *usbh_next_desc_get (uint8_t *pbuf, uint16_t *ptr);
|
||
|
|
|
||
|
|
#endif /* USBH_STD_H */
|