2020年11月02日 | STM32 USB工程的文件分析

先介绍下我参考其他工程而建立的STM32 USB工程：

简单介绍下：Startup当然放置STM32的启动文件，CMSIS放置着STM32内核ARMCortex的内核文件，StdPeripheral_Driver目录里放置着STM32外设的库函数，这几个都是STM32工程必须的，这里不仔细讲诉，User Source里放着自己的应用代码，如main.c,stm32f10x_it.c等文件都放这里。USB-FS-Driver_Driver下放着USB的库，这里暂时不讲述，我重点想分析的文件在USB-User里，这个目录主要放着一些与USB库和用户相关的文件，起着USB库与用户之间的桥梁作用，文件如下图所示，该目录包含如下文件：

接下去要分别分析下这几个文件：

hw_config.c：

这个文件主要是配置一些跟板载及系统相关的代码，比如说USB系统时钟配置，上拉电阻引脚及LED灯配置，还有USB的中断灯。主要的函数如下：

void Set_System(void);            /*设置系统时钟，USB 及LED引脚配置*/

void Set_USBClock(void);  /*设置USB的时钟频率*/

void GPIO_AINConfig(void);  /*设置GPIO模拟输入（这里是空函数）*/

void Enter_LowPowerMode(void); /*进入低功耗模式（这里是空函数）*/

void Leave_LowPowerMode(void); /*离开低功耗模式（这里是空函数）*/

void USB_Interrupts_Config(void); /*设置USB中断配置*/

void USB_Cable_Config (FunctionalState NewState);/*USB连接断开选择，其实是控制上拉电阻引脚*/

/*void Joystick_Send(uint8_t Keys);*/ /*操作杆发送（没有用)*/

/*uint8_t JoyState(void); */ /*操作杆状态（没有用到）*/

void Get_SerialNum(void);  /*创建字符串描述符的序列号*/

usb_des.c：

这个文件主要是定义了USB的一些描述符：分别是：设备描述符、配置描述符集合（包括接口描述符，HID描述符，端点描述符）、HID报告描述符、语言ID描述符、厂家的字符串描述符、产品的字符串描述符、产品序列号的字符串描述符。

CustomHID_DeviceDescriptor[CUSTOMHID_SIZ_DEVICE_DESC];

CustomHID_ConfigDescriptor[CUSTOMHID_SIZ_CONFIG_DESC];

CustomHID_ReportDescriptor[CUSTOMHID_SIZ_REPORT_DESC];

CustomHID_StringLangID[CUSTOMHID_SIZ_STRING_LANGID];

CustomHID_StringVendor[CUSTOMHID_SIZ_STRING_VENDOR];

CustomHID_StringProduct[CUSTOMHID_SIZ_STRING_PRODUCT];

CustomHID_StringSerial[CUSTOMHID_SIZ_STRING_SERIAL];

usb_endp.c:

这个文件主要是定义了几个端点输入输出的回调函数，这里指定以了端点1输入输出回调及端点2输入回调函数，如下：

void EP1_IN_Callback(void);  /*端点1输入回调函数*/

void EP1_OUT_Callback(void); /*端点1输出回调函数*/

void EP2_IN_Callback(void); /*端点2输入回调函数*/

usb_Istr.c:

这个文件主要是每个端点对应的回调函数的注册；USB中断服务程序的处理，通过读取STM32 ISTR中断状态寄存器来判断是什么中断，并做相应的专断处理。

void (*pEpInt_IN[7])(void) = /*端点输入回调函数注册*/

  {

    EP1_IN_Callback,

    EP2_IN_Callback,

    EP3_IN_Callback,

    EP4_IN_Callback,

    EP5_IN_Callback,

    EP6_IN_Callback,

    EP7_IN_Callback,

  };

      void (*pEpInt_OUT[7])(void) = /*端点输出回调函数的注册*/

  {

    EP1_OUT_Callback,

    EP2_OUT_Callback,

    EP3_OUT_Callback,

    EP4_OUT_Callback,

    EP5_OUT_Callback,

    EP6_OUT_Callback,

    EP7_OUT_Callback,

  };

  void USB_Istr(void)；/*ISTR事件中断服务程序*/

usb_propc：

这个文件主要是把之前定义的一些列描述符注册到USB库中，并且注册一些USB常用的处理函数如获取设备描述符等和一些标准请求函数，具体如下：

DEVICE_PROP Device_Property = /*注册一些CustomHID函数*/

{

    CustomHID_init, /*CustomHID的初始化函数*/

    CustomHID_Reset, /*CustomHID的复位函数*/

    CustomHID_Status_In, /*CustomHID状态输入函数*/

    CustomHID_Status_Out, /*CustomHID状态输出函数*/

    CustomHID_Data_Setup, /*CustomHID的处理带数据的特殊类请求函数*/

    CustomHID_NoData_Setup, /*CustomHID的处理不带数据特殊类请求函数*/

    CustomHID_Get_Interface_Setting, /*CustomHID获取接口及备用接口设置是否可用  */

    CustomHID_GetDeviceDescriptor, /*CustomHID获取设备描述符*/

    CustomHID_GetConfigDescriptor, /*CustomHID获取配置描述符*/

    CustomHID_GetStringDescriptor, /*CustomHID获取字符串描述符*/

    0, /*当前库未使用*/

    0x40 /*MAX PACKET SIZE*/  /*最大的包长度为64字节*/

};

/*注册USB标准请求的实现函数*/

USER_STANDARD_REQUESTS User_Standard_Requests =

{

    CustomHID_GetConfiguration, /*获取配置请求*/

    CustomHID_SetConfiguration, /*设置配置请求*/

    CustomHID_GetInterface, /*获取接口请求*/

    CustomHID_SetInterface, /*设置接口请求*/

    CustomHID_GetStatus, /*获取状态请求*/

    CustomHID_ClearFeature, /*清除特性请求*/

    CustomHID_SetEndPointFeature, /*设置端点特性请求*/

    CustomHID_SetDeviceFeature, /*设置设备特性请求*/

    CustomHID_SetDeviceAddress /*设置设备地址请求*/

};

/*注册设备描述符信息*/

ONE_DESCRIPTOR Device_Descriptor；

/*注册报告描述符信息*/

ONE_DESCRIPTOR CustomHID_Report_Descriptor;

/*注册HID描述符信息*/

ONE_DESCRIPTOR CustomHID_Descriptor;

/*注册字符串描述符，包括语言ID、厂商、产品、序列号描述符*/

ONE_DESCRIPTOR String_Descriptor[4];

usb_pwr.c：

这个文件主要一些USB与功耗方面的函数，如上电、掉电、挂起等。

void Suspend(void); /*挂起*/

void Resume_Init(void); /*恢复初始化*/

void Resume(RESUME_STATE eResumeSetVal);/*恢复到某个状态状态*/

RESULT PowerOn(void); /*上电*/

RESULT PowerOff(void); /*掉电*/

usbio.c 

这个文件只有两个文件，一个是USB发送函数，另一个当然是USB接收函数。

uint32_t USB_SendData(uint8_t *data,uint32_t dataNum)；

uint32_t USB_GetData(uint8_t *data,uint32_t dataNum)；