Detailed Description

Common parts for both HOST and DEVICE USB stacks, see USB device stack library pages for device library documentation.

Data Structures
struct	USB_ConfigurationDescriptor_TypeDef
	USB Configuration Descriptor.

struct	USB_DeviceDescriptor_TypeDef
	USB Device Descriptor.

struct	USB_EndpointDescriptor_TypeDef
	USB Endpoint Descriptor.

struct	USB_InterfaceDescriptor_TypeDef
	USB Interface Descriptor.

struct	USB_Setup_TypeDef
	USB Setup request package.

struct	USB_StringDescriptor_TypeDef
	USB String Descriptor.

Macros
#define	CLEAR_FEATURE 1

#define	CONFIG_DESC_BM_REMOTEWAKEUP 0x20

#define	CONFIG_DESC_BM_RESERVED_D7 0x80

#define	CONFIG_DESC_BM_SELFPOWERED 0x40

#define	CONFIG_DESC_BM_TRANSFERTYPE 0x03

#define	CONFIG_DESC_MAXPOWER_mA (x) (((x) + 1) / 2)

#define	DEVICE_IS_SELFPOWERED 0x0001

#define	GET_CONFIGURATION 8

#define	GET_DESCRIPTOR 6

#define	GET_INTERFACE 10

#define	GET_STATUS 0

#define	HUB_FEATURE_C_PORT_CONNECTION 16

#define	HUB_FEATURE_C_PORT_RESET 20

#define	HUB_FEATURE_PORT_INDICATOR 22

#define	HUB_FEATURE_PORT_POWER 8

#define	HUB_FEATURE_PORT_RESET 4

#define	PORT_FULL_SPEED 1

#define	PORT_LOW_SPEED 2

#define	REMOTE_WAKEUP_ENABLED 0x0002

#define	SET_ADDRESS 5

#define	SET_CONFIGURATION 9

#define	SET_DESCRIPTOR 7

#define	SET_FEATURE 3

#define	SET_INTERFACE 11

#define	SILABS_USB_VID 0x10C4

#define	STATIC_CONST_STRING_DESC (_name, ...)

#define	STATIC_CONST_STRING_DESC_LANGID (_name, x, y)

#define	STATIC_UBUF (x, y) SL_ALIGN (4) static uint8_t x[((y) + 3) & ~3] SL_ATTRIBUTE_ALIGN (4)

#define	SYNCH_FRAME 12

#define	UBUF (x, y) SL_ALIGN (4) uint8_t x[((y) + 3) & ~3] SL_ATTRIBUTE_ALIGN (4)

#define	USB_AUDIO_GET_CUR 0x81

#define	USB_AUDIO_GET_CUR 0x81

#define	USB_AUDIO_GET_MAX 0x83

#define	USB_AUDIO_GET_MEM 0x85

#define	USB_AUDIO_GET_MIN 0x82

#define	USB_AUDIO_GET_RES 0x84

#define	USB_AUDIO_GET_STAT 0xFF

#define	USB_AUDIO_SET_CUR 0x01

#define	USB_AUDIO_SET_MAX 0x03

#define	USB_AUDIO_SET_MEM 0x05

#define	USB_AUDIO_SET_MIN 0x02

#define	USB_AUDIO_SET_RES 0x04

#define	USB_CA_AS_GENERAL_DESCRIPTOR 1

#define	USB_CA_AS_GENERAL_DESCSIZE 7

#define	USB_CA_EP_GENERAL_DESCRIPTOR 1

#define	USB_CA_EP_GENERAL_DESCSIZE 7

#define	USB_CA_EXTENSION_UNIT_DESCRIPTOR 8

#define	USB_CA_FEATURE_UNIT_DESCRIPTOR 6

#define	USB_CA_FORMAT_TYPE_DESCRIPTOR 2

#define	USB_CA_HEADER_DESCRIPTOR 1

#define	USB_CA_INPUT_TERMINAL_DESCRIPTOR 2

#define	USB_CA_INPUT_TERMINAL_DESCSIZE 12

#define	USB_CA_MIXER_UNIT_DESCRIPTOR 4

#define	USB_CA_OUTPUT_TERMINAL_DESCRIPTOR 3

#define	USB_CA_OUTPUT_TERMINAL_DESCSIZE 9

#define	USB_CA_PROCESSING_UNIT_DESCRIPTOR 7

#define	USB_CA_SELECTOR_UNIT_DESCRIPTOR 5

#define	USB_CA_STD_AS_ENDPOINT_DESCSZIE 9

#define	USB_CDC_ACM_FND_DESCSIZE 4

#define	USB_CDC_CALLMNG_FND_DESCSIZE 5

#define	USB_CDC_GETLINECODING 0x21

#define	USB_CDC_HEADER_FND_DESCSIZE 5

#define	USB_CDC_SETCTRLLINESTATE 0x22

#define	USB_CDC_SETLINECODING 0x20

#define	USB_CLASS_AUDIO 1

#define	USB_CLASS_AUDIO_CONTROL 1

#define	USB_CLASS_AUDIO_MIDISTREAMING 3

#define	USB_CLASS_AUDIO_STREAMING 2

#define	USB_CLASS_CDC 2

#define	USB_CLASS_CDC_ACM 2

#define	USB_CLASS_CDC_ACMFN 2

#define	USB_CLASS_CDC_CMNGFN 1

#define	USB_CLASS_CDC_DATA 0x0A

#define	USB_CLASS_CDC_HFN 0

#define	USB_CLASS_CDC_UNIONFN 6

#define	USB_CLASS_HID 3

#define	USB_CLASS_HID_KEYBOARD 1

#define	USB_CLASS_HID_MOUSE 2

#define	USB_CLASS_HUB 9

#define	USB_CLASS_MISC_COMMON_SUBCLASS 2

#define	USB_CLASS_MISC_IAD_PROTOCOL 1

#define	USB_CLASS_MISCELLANEOUS 0xEF

#define	USB_CLASS_MSD 8

#define	USB_CLASS_MSD_BOT_TRANSPORT 0x50

#define	USB_CLASS_MSD_CSW_CMDFAILED 1

#define	USB_CLASS_MSD_CSW_CMDPASSED 0

#define	USB_CLASS_MSD_CSW_PHASEERROR 2

#define	USB_CLASS_MSD_SCSI_CMDSET 6

#define	USB_CONFIG_DESCRIPTOR 2

#define	USB_CONFIG_DESCSIZE 9

#define	USB_CS_ENDPOINT_DESCRIPTOR 0x25

#define	USB_CS_INTERFACE_DESCRIPTOR 0x24

#define	USB_DEVICE_DESCRIPTOR 1

#define	USB_DEVICE_DESCSIZE 18

#define	USB_DEVICE_QUALIFIER_DESCRIPTOR 6

#define	USB_DEVICE_QUALIFIER_DESCSIZE 10

#define	USB_DPLL_SRC_HFXO 2

#define	USB_DPLL_SRC_LFXO 1

#define	USB_ENDPOINT_DESCRIPTOR 5

#define	USB_ENDPOINT_DESCSIZE 7

#define	USB_EP_DIR_IN 0x80

#define	USB_EPNUM_MASK 0x0F

#define	USB_EPSYNC_ADAPTIVE (2 << 2)

#define	USB_EPSYNC_ASYNC (1 << 2)

#define	USB_EPSYNC_NO (0 << 2)

#define	USB_EPSYNC_SYNC (3 << 2)

#define	USB_EPTYPE_BULK 2

#define	USB_EPTYPE_CTRL 0

#define	USB_EPTYPE_INTR 3

#define	USB_EPTYPE_ISOC 1

#define	USB_FEATURE_DEVICE_REMOTE_WAKEUP 1

#define	USB_FEATURE_ENDPOINT_HALT 0

#define	USB_FS_BULK_EP_MAXSIZE 64

#define	USB_FS_CTRL_EP_MAXSIZE 64

#define	USB_FS_INTR_EP_MAXSIZE 64

#define	USB_FS_ISOC_EP_MAXSIZE 1023

#define	USB_HID_DESCRIPTOR 0x21

#define	USB_HID_DESCSIZE 9

#define	USB_HID_GET_IDLE 0x02

#define	USB_HID_GET_REPORT 0x01

#define	USB_HID_REPORT_DESCRIPTOR 0x22

#define	USB_HID_SET_IDLE 0x0A

#define	USB_HID_SET_PROTOCOL 0x0B

#define	USB_HID_SET_REPORT 0x09

#define	USB_HUB_DESCRIPTOR 0x29

#define	USB_INTERFACE_ASSOCIATION_DESCRIPTOR 11

#define	USB_INTERFACE_ASSOCIATION_DESCSIZE 8

#define	USB_INTERFACE_DESCRIPTOR 4

#define	USB_INTERFACE_DESCSIZE 9

#define	USB_INTERFACE_POWER_DESCRIPTOR 8

#define	USB_LANGID_ENUS 0x0409

#define	USB_LS_CTRL_EP_MAXSIZE 8

#define	USB_LS_INTR_EP_MAXSIZE 8

#define	USB_MAX_DEVICE_ADDRESS 127

#define	USB_MAX_STRING_DESCRIPTOR_CHARS 126

#define	USB_MSD_BOTRESET 0xFF

#define	USB_MSD_GETMAXLUN 0xFE

#define	USB_OTHER_SPEED_CONFIG_DESCRIPTOR 7

#define	USB_OTHER_SPEED_CONFIG_DESCSIZE 9

#define	USB_SETUP_DIR_D2H 0x80

#define	USB_SETUP_DIR_H2D 0x00

#define	USB_SETUP_DIR_IN 1

#define	USB_SETUP_DIR_MASK 0x80

#define	USB_SETUP_DIR_OUT 0

#define	USB_SETUP_PKT_SIZE 8

#define	USB_SETUP_RECIPIENT_DEVICE 0

#define	USB_SETUP_RECIPIENT_ENDPOINT 2

#define	USB_SETUP_RECIPIENT_INTERFACE 1

#define	USB_SETUP_RECIPIENT_OTHER 3

#define	USB_SETUP_TYPE_CLASS 1

#define	USB_SETUP_TYPE_CLASS_MASK 0x20

#define	USB_SETUP_TYPE_STANDARD 0

#define	USB_SETUP_TYPE_STANDARD_MASK 0x00

#define	USB_SETUP_TYPE_VENDOR 2

#define	USB_SETUP_TYPE_VENDOR_MASK 0x40

#define	USB_SMARTCARD_DESCRIPTOR 0x21

#define	USB_SMARTCARD_DESCSIZE 54

#define	USB_STRING_DESCRIPTOR 3

Typedefs
typedef unsigned short	char16_t

typedef int(*	USB_XferCompleteCb_TypeDef ) ( USB_Status_TypeDef status, uint32_t xferred, uint32_t remaining)
	USB transfer callback function.

typedef void(*	USBTIMER_Callback_TypeDef ) (void)
	USBTIMER callback function.

Enumerations
enum	USB_Status_TypeDef { USB_STATUS_OK = 0, USB_STATUS_REQ_ERR = -1, USB_STATUS_EP_BUSY = -2, USB_STATUS_REQ_UNHANDLED = -3, USB_STATUS_ILLEGAL = -4, USB_STATUS_EP_STALLED = -5, USB_STATUS_EP_ABORTED = -6, USB_STATUS_EP_ERROR = -7, USB_STATUS_EP_NAK = -8, USB_STATUS_DEVICE_UNCONFIGURED = -9, USB_STATUS_DEVICE_SUSPENDED = -10, USB_STATUS_DEVICE_RESET = -11, USB_STATUS_TIMEOUT = -12, USB_STATUS_DEVICE_REMOVED = -13, USB_STATUS_HC_BUSY = -14, USB_STATUS_DEVICE_MALFUNCTION = -15, USB_STATUS_PORT_OVERCURRENT = -16 }
	USB transfer status enumerator.

Functions
char *	USB_GetErrorMsgString (int error)
	Return an error message string for a given error code.

void	USB_PrintErrorMsgString (char *pre, int error)
	Format and print a text string given an error code, prepends an optional user supplied leader string.

int	USB_PRINTF (const char *format,...)
	Transmit "printf" formated data on the debug serial port.

int	USB_PUTCHAR (char c)
	Transmit a single char on the debug serial port.

void	USB_PUTS (const char *p)
	Transmit a zero terminated string on the debug serial port.

void	USBTIMER_DelayMs (uint32_t msec)
	Active wait millisecond delay function. Can also be used inside interrupt handlers.

void	USBTIMER_DelayUs (uint32_t usec)
	Active wait microsecond delay function. Can also be used inside interrupt handlers.

void	USBTIMER_Init (void)
	Activate the hardware timer used to pace the 1 millisecond timer system.

void	USBTIMER_Start (uint32_t id, uint32_t timeout, USBTIMER_Callback_TypeDef callback)
	Start a timer.

void	USBTIMER_Stop (uint32_t id)
	Stop a timer.

Macro Definition Documentation

#define CLEAR_FEATURE 1

Standard setup request CLEAR_FEATURE.

Definition at line 90 of file em_usb.h .

Referenced by MSDD_SetupCmd() .

#define CONFIG_DESC_BM_REMOTEWAKEUP 0x20

Configuration descriptor attribute macro.

Definition at line 193 of file em_usb.h .

#define CONFIG_DESC_BM_RESERVED_D7 0x80

Configuration descriptor attribute macro.

Definition at line 195 of file em_usb.h .

#define CONFIG_DESC_BM_SELFPOWERED 0x40

Configuration descriptor attribute macro.

Definition at line 194 of file em_usb.h .

#define CONFIG_DESC_BM_TRANSFERTYPE 0x03

Configuration descriptor transfer type bitmask.

Definition at line 196 of file em_usb.h .

Referenced by USBD_Init() .

#define CONFIG_DESC_MAXPOWER_mA ( x ) (((x) + 1) / 2)

Configuration descriptor power macro.

Definition at line 197 of file em_usb.h .

#define DEVICE_IS_SELFPOWERED 0x0001

Standard request GET_STATUS bitmask.

Definition at line 199 of file em_usb.h .

#define GET_CONFIGURATION 8

Standard setup request GET_CONFIGURATION.

Definition at line 95 of file em_usb.h .

#define GET_DESCRIPTOR 6

Standard setup request GET_DESCRIPTOR.

Definition at line 93 of file em_usb.h .

Referenced by HIDKBD_SetupCmd() , and USBX_SetupCmdCb() .

#define GET_INTERFACE 10

Standard setup request GET_INTERFACE.

Definition at line 97 of file em_usb.h .

#define GET_STATUS 0

Standard setup request GET_STATUS.

Definition at line 89 of file em_usb.h .

#define HUB_FEATURE_C_PORT_CONNECTION 16