1。azerty或QWERTY键盘的选择是通过在文件usbh_hid_keybrd.h中# qwerty_keyboard， # azerty_keyboard来声明的

3库用户API和回调函数 3.1库用户API

库用户API功能局限于以下两个功能：

■void usbh_process（void）：此功能实现的核心状态机程序。它要从用户的主循环周期调用。 ■usbh_init：这个函数应该被称为主机的USB硬件与库的初始化。 下面为usbh_init的函数原型：

void USBH_Init(USB_OTG_CORE_HANDLE *pdev, USBH_Class_cb_TypeDef *class_cb, USBH_Usr_cb_TypeDef *usr_cb)

–pdev：指向USB主机寄存器核心结构的指针（为了将来需要）

–class_cb：指针指向类结构USBH_Class_cb_TypeDef，它既可以指向MSC_cb类来操作MSC设备也可以指向HID_cb类操作HID鼠标/键盘设备。

–usr _cb：指向USBH_Usr_cb_TypeDef类结构。这个结构定义独立类回调函数。（见3.2.2节）

3.2用户的回调函数

用户回调函数在用户模板文件usbh_usr.c中声明 定义了两种类型的用户回调：

■与类的相关操作的回调函数（MSC或HID）

■与类操作相独立的回调函数；他们主要是在枚举阶段被调用。这些回调是一个USBH_Usr_cb_TypeDef结构类型中定义 3.2.1类的回调函数 MSC用户回调函数功能

对于MSC，下面的回调函数被调用：int usr_msc_application（void）。

类的初始化结束后，这个函数被MSC状态机调用的为了帮助用户访问文件操作系统。 在这个回调函数，用户可以访问任何FAT文件系统（文件打开，文件读，写文件……）使用EFSL文件系统API。

同时，用户可以访问一个与库MSC类驱动不同的出口结构变量，usbh_msc_param。这个变量提供关于大容量存储的关键信息。

这个变量是使用一种类型massstorageparameter_typedef定义的结构，定义如下： typedef struct __MassStorageParameter {

uint32_t MSCapacity; /*MS device capacity in bytes */

uint32_t MSSenseKey; /*Request Sense SCSI command returned value */ uint16_t MSPageLength; /* MS device Page length */ uint8_t MSBulkOutEp; /* Bulk OUT endpoint address */ uint8_t MSBulkInEp; /*Bulk IN endpoint address */

uint8_t MSWriteProtect; /*Write protection status, 0: non protected, 1:protected */ } MassStorageParameter_TypeDef; HID用户的回调函数

对HID类，以下定义的回调函数：

■void USR_MOUSE_Init(void)：用户的鼠标应用程序初始化 ■void USR_KEYBRD_Init(void)：键盘应用的用户初始化

■void USR_MOUSE_ProcessData(HID_MOUSE_Data_TypeDef *data)：这个回调函数 被调用当hid_mouse_data_typedef数据类型的输入参数有效时（见下面附注1）。 ■void USR_KEYBRD_ProcessData (uint8_t data)：这个回调被调用时，一个新的ASCII字符型。其特征是输入参数数据。

注：1 HID_MOUSE_Data_TypeDef定义如下：

typedef struct _HID_MOUSE_Data {

uint8_t x; uint8_t y;

uint8_t z; /* Not Supported */

uint8_t button; /*Bitmap showing pressed buttons 1:pressed, 0: non pressed */ }

HID_MOUSE_Data_TypeDef; 3.2.2类独立的回调函数

这类独立的回调函数是在一个结构类型定义 usbh_usr_cb_typedef定义如下：

typedef struct _USBH_USR_PROP {

void (*Init)(void);

void (*DeviceAttached)(void); void (*ResetDevice)(void);

void (*DeviceDisconnected)(void); void (*OverCurrentDetected)(void);

void (*DeviceSpeedDetected)(uint8_t DeviceSpeed); void (*DeviceDescAvailable)(void *); void (*DeviceAddressAssigned)(void);

void (*ConfigurationDescAvailable)(USBH_CfgDesc_TypeDef *, USBH_InterfaceDesc_TypeDef *, USBH_EpDesc_TypeDef *);

void (*ManufacturerString)(void *); void (*ProductString)(void *); void (*SerialNumString)(void *); void (*EnumerationDone)(void);

USBH_USR_Status (*UserInput)(void);

void (*USBH_USR_DeviceNotSupported)(void); void (*UnrecoveredError)(void); }

USBH_Usr_cb_TypeDef; 以上回调函数功能描述如下。

–初始化：初始化时被usbh_init内核调用的功能。在这个功能，用户可以实现任何自己的应用程序相关的特定的初始化。

–deviceattached：当一个USB设备连接时被调用。它可以通过显示屏告诉用户任何有用的设备连接信息。

–devicereset：从主模式发出的USB复位命令。 –devicedisconnect：“当一个设备断开时调用。

–overcurrentdetected：对USB的VBUS电流进行检测时调用。 –devicespeeddetected：检测装置传输速率时调用 –devicedescavailable：设备描述符有效时调用 –deviceaddressassigned：当设备地址分配时调用。

–configurationdescavailable：当设备，接口和端点描述符可用时调用描述符是可用的 –manufacturingstring：提取制造商字符串时调用。 –productstring：提取设备字符串时调用。 –serialnumstring：序列号字符串提取时调用。 –enumerationdone：枚举完成时调用。

–userinput：枚举的过程结束后，提示用户进一步的行动，如按下一个按钮启动主模式的类操作

–usbh_usr_devicenotsupported：被检测的设备是在不在当前类驱动程序支持时调用。 –unrecoverederror：在“host_error_state”状态时调用内核的状态机。它允许用户处理任何错误，在液晶屏上显示一个错误的信息，例如。

注：1设备的速率信息是通过devicespeed参数返回。可能的值是：0x1对应全速设备，0x2对应低速设备。

2设备描述符的信息通过指针DeviceDesc返回，它指向usbh_devdesc_typedefdefined型结构如下：

typedef struct _DeviceDescriptor {

uint8_t bLength;

uint8_t bDescriptorType;

uint16_t bcdUSB; /* USB Specification Number which device complies too */ uint8_t bDeviceClass;

uint8_t bDeviceSubClass; uint8_t bDeviceProtocol; uint8_t bMaxPacketSize;

uint16_t idVendor; /* Vendor ID (Assigned by USB Org) */

uint16_t idProduct; /* Product ID (Assigned by Manufacturer) */ uint16_t bcdDevice; /* Device Release Number */

uint8_t iManufacturer; /* Index of Manufacturer String Descriptor */ uint8_t iProduct; /* Index of Product String Descriptor */

uint8_t iSerialNumber; /* Index of Serial Number String Descriptor */ uint8_t bNumConfigurations; /* Number of Possible Configurations */ }

USBH_DevDesc_TypeDef;

3设备配置信息（配置，接口和端点描述符）通过结构指针返回usbh_cfgdesc_typedef，usbh_interfacedesc_typedef和usbh_epdesc_typedefdefined定义如下： typedef struct _ConfigurationDescriptor {

uint8_t bLength;

uint8_t bDescriptorType; uint16_t wTotalLength; uint8_t bNumInterfaces; uint8_t bConfigurationValue; uint8_t iConfiguration; uint8_t bmAttributes; uint8_t bMaxPower; }

USBH_CfgDesc_TypeDef;

typedef struct _InterfaceDescriptor {

uint8_t bLength;

uint8_t bDescriptorType; uint8_t bInterfaceNumber;

uint8_t bAlternateSetting; /* Value used to select alternative setting */ uint8_t bNumEndpoints; /* Number of Endpoints used for this interface */ uint8_t bInterfaceClass; /* Class Code (Assigned by USB Org) */

uint8_t bInterfaceSubClass; /* Subclass Code (Assigned by USB Org) */ uint8_t bInterfaceProtocol; /* Protocol Code */

uint8_t iInterface; /* Index of String Descriptor Describing this interface */ }

USBH_InterfaceDesc_TypeDef; typedef struct _EndpointDescriptor {

uint8_t bLength;

uint8_t bDescriptorType;

uint8_t bEndpointAddress; /* indicates what endpoint this descriptor is describing */

uint8_t bmAttributes; /* specifies the transfer type. */

uint16_t wMaxPacketSize; /* Maximum Packet Size this endpoint is capable of sending or receiving */

uint8_t bInterval; /* is used to specify the polling interval of certain transfers. */ }

USBH_EpDesc_TypeDef;

4为了移动内核状态机到host_class_request状态，userinput回调函数应该返回值usbh_usr_resp_ok类型的usbh_usr_status typedef enum {