Sample API functions for using USB.

Data Structures
struct	USB_Setup_TypeDef
	USB Setup request package.

struct	USB_DeviceDescriptor_TypeDef
	USB Device Descriptor.

struct	USB_ConfigurationDescriptor_TypeDef
	USB Configuration Descriptor.

struct	USB_InterfaceDescriptor_TypeDef
	USB Interface Descriptor.

struct	USB_EndpointDescriptor_TypeDef
	USB Endpoint Descriptor.

struct	USB_StringDescriptor_TypeDef
	USB String Descriptor.

Macros
#define	USB_SETUP_DIR_OUT 0

#define	USB_SETUP_DIR_IN 1

#define	USB_SETUP_DIR_MASK 0x80

#define	USB_SETUP_DIR_D2H 0x80

#define	USB_SETUP_DIR_H2D 0x00

#define	USB_SETUP_TYPE_STANDARD 0

#define	USB_SETUP_TYPE_CLASS 1

#define	USB_SETUP_TYPE_VENDOR 2

#define	USB_SETUP_TYPE_STANDARD_MASK 0x00

#define	USB_SETUP_TYPE_CLASS_MASK 0x20

#define	USB_SETUP_TYPE_VENDOR_MASK 0x40

#define	USB_SETUP_RECIPIENT_DEVICE 0

#define	USB_SETUP_RECIPIENT_INTERFACE 1

#define	USB_SETUP_RECIPIENT_ENDPOINT 2

#define	USB_SETUP_RECIPIENT_OTHER 3

#define	GET_STATUS 0

#define	CLEAR_FEATURE 1

#define	SET_FEATURE 3

#define	SET_ADDRESS 5

#define	GET_DESCRIPTOR 6

#define	SET_DESCRIPTOR 7

#define	GET_CONFIGURATION 8

#define	SET_CONFIGURATION 9

#define	GET_INTERFACE 10

#define	SET_INTERFACE 11

#define	SYNCH_FRAME 12

#define	USB_HID_GET_REPORT 0x01

#define	USB_HID_GET_IDLE 0x02

#define	USB_HID_SET_REPORT 0x09

#define	USB_HID_SET_IDLE 0x0A

#define	USB_HID_SET_PROTOCOL 0x0B

#define	USB_CDC_SETLINECODING 0x20

#define	USB_CDC_GETLINECODING 0x21

#define	USB_CDC_SETCTRLLINESTATE 0x22

#define	USB_MSD_BOTRESET 0xFF

#define	USB_MSD_GETMAXLUN 0xFE

#define	USB_DEVICE_DESCRIPTOR 1

#define	USB_CONFIG_DESCRIPTOR 2

#define	USB_STRING_DESCRIPTOR 3

#define	USB_INTERFACE_DESCRIPTOR 4

#define	USB_ENDPOINT_DESCRIPTOR 5

#define	USB_DEVICE_QUALIFIER_DESCRIPTOR 6

#define	USB_OTHER_SPEED_CONFIG_DESCRIPTOR 7

#define	USB_INTERFACE_POWER_DESCRIPTOR 8

#define	USB_HUB_DESCRIPTOR 0x29

#define	USB_HID_DESCRIPTOR 0x21

#define	USB_HID_REPORT_DESCRIPTOR 0x22

#define	USB_CS_INTERFACE_DESCRIPTOR 0x24

#define	USB_DEVICE_DESCSIZE 18

#define	USB_CONFIG_DESCSIZE 9

#define	USB_INTERFACE_DESCSIZE 9

#define	USB_ENDPOINT_DESCSIZE 7

#define	USB_DEVICE_QUALIFIER_DESCSIZE 10

#define	USB_OTHER_SPEED_CONFIG_DESCSIZE 9

#define	USB_HID_DESCSIZE 9

#define	USB_CDC_HEADER_FND_DESCSIZE 5

#define	USB_CDC_CALLMNG_FND_DESCSIZE 5

#define	USB_CDC_ACM_FND_DESCSIZE 4

#define	USB_EP0_SIZE 8

#define	USB_EP1_SIZE 8

#define	USB_EP2_SIZE 8

#define	USB_EP3_SIZE 64

#define	USB_EP4_SIZE 32

#define	USB_EP5_SIZE 64

#define	USB_EP6_SIZE 512

#define	USB_MAX_EP_SIZE 64

#define	USB_EPTYPE_CTRL 0

#define	USB_EPTYPE_ISOC 1

#define	USB_EPTYPE_BULK 2

#define	USB_EPTYPE_INTR 3

#define	USB_EP_DIR_IN 0x80

#define	USB_SETUP_PKT_SIZE 8

#define	USB_EPNUM_MASK 0x0F

#define	USB_LANGID_ENUS 0x0409

#define	USB_MAX_DEVICE_ADDRESS 127

#define	CONFIG_DESC_BM_REMOTEWAKEUP 0x20

#define	CONFIG_DESC_BM_SELFPOWERED 0x40

#define	CONFIG_DESC_BM_RESERVED_D7 0x80

#define	CONFIG_DESC_BM_TRANSFERTYPE 0x03

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

#define	DEVICE_IS_SELFPOWERED 0x0001

#define	REMOTE_WAKEUP_ENABLED 0x0002

#define	USB_FEATURE_ENDPOINT_HALT 0

#define	USB_FEATURE_DEVICE_REMOTE_WAKEUP 1

#define	HUB_FEATURE_PORT_RESET 4

#define	HUB_FEATURE_PORT_POWER 8

#define	HUB_FEATURE_C_PORT_CONNECTION 16

#define	HUB_FEATURE_C_PORT_RESET 20

#define	HUB_FEATURE_PORT_INDICATOR 22

#define	USB_CLASS_CDC 2

#define	USB_CLASS_CDC_DATA 0x0A

#define	USB_CLASS_CDC_ACM 2

#define	USB_CLASS_CDC_HFN 0

#define	USB_CLASS_CDC_CMNGFN 1

#define	USB_CLASS_CDC_ACMFN 2

#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_MSD 8

#define	USB_CLASS_MSD_BOT_TRANSPORT 0x50

#define	USB_CLASS_MSD_SCSI_CMDSET 6

#define	USB_CLASS_MSD_CSW_CMDPASSED 0

#define	USB_CLASS_MSD_CSW_CMDFAILED 1

#define	USB_CLASS_MSD_CSW_PHASEERROR 2

#define	PORT_FULL_SPEED 1

#define	PORT_LOW_SPEED 2

#define	nibble2Ascii (n) ((n) + (((n) < 10) ? '0' : 'A' - 10));

#define	STATIC_CONST_STRING_DESC (_name, ...)

#define	STATIC_CONST_STRING_DESC_LANGID (_name, x, y)

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

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

Typedefs
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
void	USBTIMER_DelayMs (uint32_t msec)

void	USBTIMER_DelayUs (uint32_t usec)

void	USBTIMER_Init (void)

void	USBTIMER_Start (uint32_t id, uint32_t timeout, USBTIMER_Callback_TypeDef callback)

void	USBTIMER_Stop (uint32_t id)

Detailed Description

See em_usb.h for source code.

Macro Definition Documentation

#define CLEAR_FEATURE 1

Standard setup request CLEAR_FEATURE.

#define CONFIG_DESC_BM_REMOTEWAKEUP 0x20

Configuration descriptor attribute macro.

#define CONFIG_DESC_BM_RESERVED_D7 0x80

Configuration descriptor attribute macro.

#define CONFIG_DESC_BM_SELFPOWERED 0x40

Configuration descriptor attribute macro.

#define CONFIG_DESC_BM_TRANSFERTYPE 0x03

Configuration descriptor transfer type bitmask.

Referenced by USBD_Init() .

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

Configuration descriptor power macro.

#define DEVICE_IS_SELFPOWERED 0x0001

Standard request GET_STATUS bitmask.

#define GET_CONFIGURATION 8

Standard setup request GET_CONFIGURATION.

#define GET_DESCRIPTOR 6

Standard setup request GET_DESCRIPTOR.

#define GET_INTERFACE 10

Standard setup request GET_INTERFACE.

#define GET_STATUS 0

Standard setup request GET_STATUS.

#define HUB_FEATURE_C_PORT_CONNECTION 16