这里我主要说一下如何做一个USB下位机，这里主要分3部分：1、建立工程；2、添加报文描述符；3、数据的传输。这里就不讲USB的理论知识了，有想要了解的自行百度一下就可以了。
1、首先打开USB
2、接着把USB设置为下图HID模式
3、选择外部时钟
4、配置时钟树
5、配置USB设置
下面的USB设置就有点讲究了，
6、确认后，生成代码
添加报文描述符：
这里只是建立了一个工程，你编译不会有错，不过PC还是无法识别你这个是USB设备的，因为缺少了关键的报文描述符，这里我就说一下报文描述符怎么写，这个你可以直接用HID descriptor Tool软件生成，如下图，下图就是一个报文的基本要素了，该描述符主要作用是告诉PC机一下USB的信息，简单来说就是告诉PC我有什么用。
这里我说一下这个报文的要素，第一部分你可以理解为报文头；第二部分你可以理解为USB告诉PC机问我要做什么，这里主要告诉PC机我要做一个接收与发送的设备；第三部分是结束标志。
============================================================
下面我插入一个对报文描述符进行一个简单的描述：
标签解析举例(Usage ：0x50, 0x01)：
(Usage Page标签0x0?)0x05=0000 0101 ：
0x05表示前缀，0x01为数据部分，0x05转换成二进制，就是0000 01 01，按照HID类协议5.3 generic item format的定义，这个字节被分成3个部分:
bit0~bit1代表的是这个前缀后面跟的数据长度，这里就是后面0x01的长度，两位可以表示最大4字节的数据，即bsize
bit2~bit3代表的是这个前缀的类型，总共可以有三种类型：0=main，1=global，2=local，3=reserved；
bit4~bit7代表前tag，一般分为input(二进制的1000 00 nn,即bit4~bit7=1000,代表一个tag，bit2~bit3=00，代表main，bit0~bit1=nn，代表这个前缀后面还有nn所代表的数据)，output(二进制的 1001 00 nn)，feature(1011 00 nn)，collection(1010 00 nn)，end collection(1100 00 nn)
即：
0000：Usage Page
01： bType，全局(bType=0：主项目；bType=1：全局项目；bType=2：区域项目)
01：bSzie，1字节(bSzie为项目所需数据字节数目，bSzie可为1、2、4，注意bSzie不可为3)
(Page ID)0x01: 表示该Page为Generalic Desktop Controls(Usage ID 0为保留。ID 1到0x1F为”top level” collection保留，这些ID虽然对于Application不是必须，但可以用于识别通用设备类型)
Usage = (usage page:usage ID)：其将数据的操控与它的用途作一对一的对应，所以解读报告后就可以知道每个数据作何种操作。所以“传输的数据”和“操作”只是一事件的两种描述方式。用途是以一个32位卷标(称作usage tag)来表示，高16位称作usage page(用途类页)，低16位称为usage ID(用途识别名)，文件universal serial Bus HID Usage Table完整列出所有的usage pages(用途类页)和usage ID(用途识别名)，使用者必须遵照文件的规范来声明操作的用途。用途卷标只是报告描述符诸多标签的一个，利用这些卷标取可以清楚完整的描述符操作的用途。
这里其实说的并不清楚，因为作者有点懒就不细说了，想了解更多的可以百度《圈圈教你玩USB》，这里说的比我好。
==============================================================================
言归正传，我们生成了报文描述符后，保存为.h文件，我对这些报文做了一些很浅显的解析，可能表达不够准确，打开可以看到如下代码所示：
char ReportDescriptor[34] ={ //这里34就是前面建立工程第五点说的，报文描述符大小0x06, 0x00, 0xff, //USAGE_PAGE (Vendor Defined Page 1) 表示一个报文标签之类的用途类页
0x09, 0x01, //USAGE (Vendor Usage 1) 表示一个报告ID标志
0xa1, 0x01, //COLLECTION (Application) 表示应用集合，要以下面最后的0xc0结束它
0x09, 0x01, //USAGE (Vendor Usage 1)同下同名解析
0x15, 0x00, //LOGICAL_MINIMUM (0) 同下同名解析
0x26, 0xff, 0x00, //LOGICAL_MAXIMUM (255) 同下同名解析
0x95, 0x40, //REPORT_COUNT (64)同下REPORT_COUNT
0x75, 0x08, //REPORT_SIZE (8)同下REPORT_SIZE
0x81, 0x02, //INPUT (Data,Var,Abs)表示USB要输入数据到PC的功能
0x09, 0x01, //USAGE (Vendor Usage 1) 每个功能的一个卷标志
0x15, 0x00, //LOGICAL_MINIMUM (0) 表示每个传输数据限定为0
0x26, 0xff, 0x00, //LOGICAL_MAXIMUM (255) 表示每个传输数据的最大值限定为255
0x95, 0x40, //REPORT_COUNT (64) 每次接收的数据长度，这里是64位
0x75, 0x08, //REPORT_SIZE (8) 传输字段的宽度为8bit，表示每个传输的数据范围为0~ffff ffff
0x91, 0x02, //OUTPUT (Data,Var,Abs) 表示USB设备要接收PC的数据的功能
0xc0 //END_COLLECTION结束标志
};
到这里我们就可以下一步了，打开刚才建立的工程，在usbd_custom_hid_if.c 文件里，找到 CUSTOM_HID_ReportDesc_FS 这个函数，把刚才生成的报文文件覆盖掉函数里面的文件，代码如下：
/** Usb HID report descriptor.*/__ALIGN_BEGINstatic uint8_t CUSTOM_HID_ReportDesc_FS[USBD_CUSTOM_HID_REPORT_DESC_SIZE] __ALIGN_END ={0x06, 0x00, 0xff, //USAGE_PAGE (Vendor Defined Page 1)
0x09, 0x01, //USAGE (Vendor Usage 1)
0xa1, 0x01, //COLLECTION (Application)
0x09, 0x01, //USAGE (Vendor Usage 1)
0x15, 0x00, //LOGICAL_MINIMUM (0)
0x26, 0xff, 0x00, //LOGICAL_MAXIMUM (255)
0x95, 0x40, //REPORT_COUNT (64)
0x75, 0x08, //REPORT_SIZE (8)
0x81, 0x02, //INPUT (Data,Var,Abs)
0x09, 0x01, //USAGE (Vendor Usage 1)
0x15, 0x00, //LOGICAL_MINIMUM (0)
0x26, 0xff, 0x00, //LOGICAL_MAXIMUM (255)
0x95, 0x40, //REPORT_COUNT (64)
0x75, 0x08, //REPORT_SIZE (8)
0x91, 0x02, //OUTPUT (Data,Var,Abs)
0xc0 //END_COLLECTION
};
然后再修改将usbd_conf.h做对应修改：
#define USBD_CUSTOMHID_OUTREPORT_BUF_SIZE 64
#define USBD_CUSTOM_HID_REPORT_DESC_SIZE 34
同时修改usbd_customhid.h文件中的发送与接收长度为64
#define CUSTOM_HID_EPIN_SIZE 0x40
#define CUSTOM_HID_EPOUT_SIZE 0x40
到这里基本就算做出一个USB设备了，我们编译下载程序看看。
如果电脑显示了这个USB设备，但是有黄色感叹号，说明USB枚举成功，可是驱动安装失败，这时我们可以libusb自带的inf-wizard工具生成USB驱动程序，要怎么安装驱动解决这个问题可以参考驱动安装：/niepangu/article/details/44984325，驱动安装成功的话，到这里我们就可以看到USB正常列举出来啦，下面我们就可以写USB数据收发代码了。
关于数据传输，HID设备是采用轮询方式传输的，ST默认20ms速度实在不敢恭维，还得要改一下枚举时的声明，同样是usbd_customhid.c文件，
__ALIGN_BEGIN static uint8_t USBD_CUSTOM_HID_CfgDesc[USB_CUSTOM_HID_CONFIG_DESC_SIZ] __ALIGN_END ={
....
....0x20, /*bInterval: Polling Interval (20 ms)*/
/*34*/....
....0x20,/*bInterval: Polling Interval (20 ms)*/
/*41*/}
这两个地方随心来改，最小可以改到0x01。这就快很多啦。到这里数据传输准备工作就做好了，下面我们先来说一下USB发送:
先定义个发送BUFF：
uint8_t send_buf[64] = {//定义一个USB的发送BUFF
1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64};
再包括发送函数头文件以及声明一个外部定义：
#include "usbd_customhid.h" //包括发送函数头文件
extern USBD_HandleTypeDef hUsbDeviceFS; //外部声明USB发送函数
现在可以在main函数里添加发送代码了，我这里设置按一下按键就发送一次，同时led亮1s：
while (1)
{
/*USER CODE BEGIN 3*/
if(HAL_GPIO_ReadPin(GPIOE,k1_Pin)==0)
{//按键消抖
while(HAL_GPIO_ReadPin(GPIOE,k1_Pin)==0);//点亮指示灯
HAL_GPIO_WritePin(GPIOE,led1_Pin,GPIO_PIN_RESET);//USB发送数据
USBD_CUSTOM_HID_SendReport(&hUsbDeviceFS, send_buf, sizeof(send_buf));
//实际发送到上位机的数据有65个，一个报文ID：0 + 64个send_buf 数据，一共65个数据到上位机
HAL_Delay(1000);//关闭指示灯
HAL_GPIO_WritePin(GPIOE,led1_Pin,GPIO_PIN_SET);
}
}
发送函数就是这么简单，接下来说接收函数了，接收函数是中断接收的，建立工程时已经默认开启了。下面就说一下USB接收：
先在main.c定义个接收BUFF：
unsigned char USB_Recive_Buffer[64]; //USB接收缓存
unsigned char USB_Received_Count = 0;//USB接收数据计数
打开usbd_custom_hid_if.c文件，添加外部声明：
extern unsigned char USB_Recive_Buffer[64];extern unsigned char USB_Received_Count;
接着在usbd_custom_hid_if.c文件中找到 static int8_t CUSTOM_HID_OutEvent_FS(uint8_t event_idx, uint8_t state) 函数，当USB接收完数据后，就会进入到这个函数，我们可以在这里添加接收函数，把函数修改如下：
/**
* @brief Manage the CUSTOM HID class events
* @param event_idx: Event index
* @param state: Event state
* @retval USBD_OK if all operations are OK else USBD_FAIL*/
//当芯片完成一组数据接收的时候，中断会调用CUSTOM_HID_OutEvent_FS这个回调函数
staticint8_t CUSTOM_HID_OutEvent_FS(uint8_t event_idx, uint8_t state)
{/*USER CODE BEGIN 6*/
chari;
HAL_GPIO_TogglePin(GPIOE,led1_Pin);/*查看接收数据长度
USB_Received_Count = USBD_GetRxCount( &hUsbDeviceFS,CUSTOM_HID_EPOUT_ADDR );
printf("USB_Received_Count = %d \r\n",USB_Received_Count);
USB_Received_Count = USBD_GetRxCount( &hUsbDeviceFS,CUSTOM_HID_EPIN_ADDR );
printf("USB_Received_Count_in = %d \r\n",USB_Received_Count);*/USBD_CUSTOM_HID_HandleTypeDef*hhid; //定义一个指向USBD_CUSTOM_HID_HandleTypeDef结构体的指针
hhid = (USBD_CUSTOM_HID_HandleTypeDef*)hUsbDeviceFS.pClassData;//得到USB接收数据的储存地址
for(i=0;i<64;i++)
{
USB_Recive_Buffer[i]=hhid->Report_buf[i]; //把接收到的数据送到自定义的缓存区保存(Report_buf[i]为USB的接收缓存区)
//printf("USB_Recive_Buffer[%d] = 0x%x \r\n",i,USB_Recive_Buffer[i]); //打印接收到的信息，确认是否正确，调试用
}returnUSBD_OK;/*USER CODE END 6*/}
这样就USB_Recive_Buffer[i] 里面就保存到接收到的数据了，用Bus Hound可以看到已经成功啦。
