STM32 USB相关知识扫盲
本篇文章为我个人在学习USB相关知识的整理，可能有不对的地方，欢迎指正！
我学习USB相关知识参考了以下网友的帖子：
http://www.51hei.com/bbs/dpj-40953-1.html
https://blog.csdn.net/alien75/article/details/4622319
1、基础知识
等级划分：
接口类型：
STM32基础型(F1系列)所带的USB是全速。
2、电气属性
USB的通信都是由主机发起的，这一点与IIC协议是类似的。
2.1 数据线
USB使用差分传输模式，有两条数据线，分别是：
- USB数据正信号线，USB Data Positive，即USB-DP线，简写为D+
- USB数据负信号线，USB Data Minus， 即USB-DM线，简写为D-
剩下的就是电源线(5V-Vbus)和地线(GND)。
2.2 USB主机是如何识别设备是高速设备/全速设备/低速设备？
主机的D+和D-都接有15K下拉电阻。
- 全速USB设备的数据线D+接有1.5K的上拉电阻，一旦接入主机，主机的D+被拉高
- 低速USB设备的数据线D-接有1.5K的上拉电阻，一旦接入主机，主机的D-会被拉高
因此，主机就可以根据检测到自己的D+为高还是D-为高，从而判断接入的设备是一个全速还是低速设备。
所以你可以看到STM32板子上的USB口D+有一个上拉电阻，而且是必须有的：
3、USB设备分类
看一个CDC虚拟串口的设备分类：
在看一个MSC的（模拟U盘）：
不同的类有不同的用途；不同的应用场合对应不同的产品形态；不同的产品形态可能会有自己特殊的描述符，比如： HID类有报告描述符、CDC类有ACM、Union描述符等。
4、描述符详解
以STM32里的MSC设备为例，MSC类所需要的描述符有：设备描述符+配置描述符+接口描述符(数量由配置描述符里的bNumInterfaces字段决定)+端点描述符(数量由配置描述符里的bNumEndpoints决定)，所以MSC类结构就是这样的：
配置描述符
{
接口描述符1
{
端点描述符1
{
}
端点描述符2
{
}
}
}
而CDC类是这样的：
配置描述符
{
接口描述符1（通信接口）
{
其他描述符（特殊描述符）
{
/*Header Functional Descriptor*/
/*Call Management Functional Descriptor*/
/*ACM Functional Descriptor*/
/*Union Functional Descriptor*/
}
端点描述符(命令端点)
{
}
}
接口描述符2（数据接口）
{
端点描述符1（输出端口）
{
}
端点描述符2（输入端口）
{
}
}
}
4.1 设备描述符
每个USB设备都必须且只有一个设备描述符，摘取一下STM32的MSC设备里的实例代码：
每个字段的含义：
- bLength：描述符大小．固定为0x12；
- bDescriptorType：设备描述符类型．固定为0x01；
- bcdUSB：USB 规范发布号．表示了本设备能适用于那种协议，如2.0=0200，1.1=0110；
- bDeviceClass：类型代码（由USB指定）。当它的值是0时，表示所有接口在配置描述符里，并且所有接口是独立的。当它的值是1到FEH时，表示不同的接口关联的。当它的值是FFH时，它是厂商自己定义的；
- bDeviceSubClass：子类型代码（由USB分配），如果 bDeviceClass值是0，一定要设置为0。其它情况就跟据USB-IF组织定义的编码；
- bDeviceProtocol：协议代码（由USB分配），如果使用USB-IF组织定义的协议，就需要设置这里的值，否则直接设置为0。如果厂商自己定义的可以设置为FFH；
- bMaxPacketSize0：端点０最大分组大小（只有8,16,32,64有效）；
- idVendor：供应商ID（由USB分配）；
- idProduct ： 产品ID（由厂商分配)，由供应商ID和产品ID，就可以让操作系统加载不同的驱动程序
- bcdDevice ：设备出产编码．由厂家自行设置；
- iManufacturer ：厂商描述符字符串索引．索引到对应的字符串描述符． 为０则表示没有；
- iProduct ：产品描述符字符串索引．同上；
- iSerialNumber：设备序列号字符串索引．同上；
- bNumConfigurations ：可能的配置数．指配置字符串的个数。
4.2 配置描述符
配置描述符定义了设备的配置信息，一个设备可以有多个配置描述符。摘一个STM32的MSC设备的配置描述符：
用C语言组合就是这样的一个结构：
typedef struct _USB_CONFIGURATION_DESCRIPTOR_
{
BYTE bLength,
BYTE bDescriptorType,
uint16_t wTotalLength,
BYTE bNumInterfaces,
BYTE bConfigurationValue,
BYTE iConfiguration,
BYTE bmAttributes,
BYTE MaxPower
}USB_CONFIGURATION_DESCRIPTOR;
每个字段含义如下：
- bLength：描述符大小，固定为0x09．
- bDescriptorType：配置描述符类型，固定为0x02．
- wTotalLength：返回整个数据的长度，指此配置返回的配置描述符，接口描述符以及端点描述符的全部大小
- bNumInterfaces：配置所支持的接口数。指该配置配备的接口数量也表示该配置下接口描述符数量
- bConfigurationValue：作为Set Configuration的一个参数选择配置值
- iConfiguration：用于描述该配置字符串描述符的索引
- bmAttributes：供电模式选择，Bit4-0保留，D7:总线供电，D6:自供电，D5:远程唤醒
- MaxPower：总线供电的USB设备的最大消耗电流．以2mA为单位
4.3 接口描述符
接口描述符说明了接口所提供的配置，一个配置所拥有的接口数量通过配置描述符的bNumInterfaces决定，摘取STM32的MSC设备类的接口描述符：
用C语言组合就是这样的一个结构：
typedef struct _USB_INTERFACE_DESCRIPTOR_
{
BYTE bLength,
BYTE bDescriptorType,
BYTE bInterfaceNumber,
BYTE bAlternateSetting,
BYTE bNumEndpoint,
BYTE bInterfaceClass,
BYTE bInterfaceSubClass,
BYTE bInterfaceProtocol,
BYTE iInterface
}USB_INTERFACE_DESCRIPTOR;
每个字段含义如下：
- bLength : 描述符大小．固定为0x09．
- bDescriptorType : 接口描述符类型．固定为0x04．
- bInterfaceNumber: 该接口的编号．
- bAlternateSetting : 用于为上一个字段选择可供替换的位置．即备用的接口描述符标号．
- bNumEndpoint : 使用的端点数目．端点０除外．
- bInterfaceClass : 类型代码（由USB分配）．
- bInterfaceSubClass : 子类型代码（由USB分配）．
- bInterfaceProtocol : 协议代码（由USB分配）．
- iInterface : 字符串描述符的索引
4.4 端点描述符
USB设备中的每个端点都有自己的端点描述符，由接口描述符中的bNumEndpoint决定其数量。摘取STM32的MSC设备类的端口描述符：
用C语言组合就是这样的一个结构：
typedef struct _USB_ENDPOINT_DESCRIPTOR_
{
BYTE bLength,
BYTE bDescriptorType,
BYTE bEndpointAddress,
BYTE bmAttributes,
uint16_t wMaxPacketSize,
BYTE bInterval
}USB_ENDPOINT_DESCRIPTOR;
每个字段含义如下：
- bLength : 描述符大小．固定为0x07
- bDescriptorType : 接口描述符类型．固定为0x05
- bEndpointType : USB设备的端点地址．Bit7决定方向，1为IN端点，0为OUT端点，对于控制端点可以忽略；Bit6-4，保留；BIt3-0：端点号
- bmAttributes : 端点属性．Bit7-2，保留．BIt1-0：00控制，01同步，02批量，03中断
- wMaxPacketSize : 本端点接收或发送的最大信息包大小
- bInterval : 轮训数据传送端点的时间间隔．对于批量传送和控制传送的端点忽略．对于同步传送的端点，必须为１，对于中断传送的端点，范围为1-255
4.5 字符串描述符
字符串描述符是可选的，如果不支持字符串描述符，其设备描述符、配置描述符、接口描述符内的所有字符串描述符索引都必须为0。
字符串描述符结构如下：
typedef struct _USB_STRING_DESCRIPTION_
{
BYTE bLength,
BYTE bDescriptionType,
BYTE bString[1];
}USB_STRING_DESCRIPTION;
各个字段含义：
- bLength : 描述符大小．由整个字符串的长度加上bLength和bDescriptorType的长度决定．
- bDescriptorType : 接口描述符类型，固定为0x03．
- bString[1] : Unicode编码字符串
4.6 IAD描述符
USB组合设备一般用Interface Association Descriptor（IAD）实现，就是在要合并的接口前加上IAD描述符。例如你想用一个硬件USB接口实现两个功能，又能到U盘又能当虚拟串口，那么在USB配置描述符中就需要加上IAD描述符来指明。
typedef struct _USBInterfaceAssociationDescriptor
{
BYTE bLength: 0x08 //描述符大小，固定
BYTE bDescriptorType: 0x0B //IAD描述符类型，固定
BYTE bFirstInterface: 0x00 //起始接口编号
BYTE bInterfaceCount: 0x02 //本个IAD下设备类的接口数量
BYTE bFunctionClass: 0x0E //类型代码，本个IAD指示的是什么类型的设备，例如CDC是0X02，MSC是0X08
BYTE bFunctionSubClass: 0x03 //子类型代码
BYTE bFunctionProtocol: 0x00 //协议代码
BYTE iFunction: 0x04 //描述字符串索引
}
以MSC+CDC为例，他的配置描述符结构就是这样的：
配置描述符
{
IAD描述符1（CDC）
{
接口描述符1（通信接口）
{
其他描述符（特殊描述符）
{
/*Header Functional Descriptor*/
/*Call Management Functional Descriptor*/
/*ACM Functional Descriptor*/
/*Union Functional Descriptor*/
}
端点描述符(命令端点)
{
}
}
接口描述符2（数据接口）
{
端点描述符1（输出端口）
{
}
端点描述符2（输入端口）
{
}
}
}
IAD描述符(MSC)
{
接口描述符1
{
端点描述符1
{
}
端点描述符2
{
}
}
}
}
5、STM32-USB详解
这个512字节SRAM叫做Packet Buffer Memory Area(简称PMA)，这个很重要，后面会详细讲解。
根据描述可以，一共有8个端点，16个寄存器，一个端点关联两个寄存器，所以我们可以将他们规划为8个输入端点(0x80-0X87)+8个输出端点(0X00-0X07)。
6、STM32-PMA详解
先说一下USB的数据包大小，全速设备的最大包大小为64字节，高速最大为1024字节。
Packet Buffer Memory Area(简称PMA)
STM32F1/F3/L1系列都有且结构相同(其他系列暂未考证)，译过来就是包数据缓存区，大小为512字节，按2字节进行寻址。
这个PMA的作用就是USB设备模块用来实现MCU与主机进行数据通信的一个专门的数据缓冲区，我们称之为USB硬件缓冲区。
说得具体点就是USB模块把来自主机的数据接收进来后先放到PMA，然后再被拷贝到用户数据缓存区；或者MCU要发送到主机的数据，先从用户数据缓存区拷贝进PMA，再通过USB模块负责发送给主机。
很多人利用ST官方的USB库修改自己的USB应用时候卡住，获取改完之后懵懵懂懂出现错误，估计大多数原因就在此处的修改！
摘取一下STM32F1参考手册里的PMA描述表：
名称含义：
ADDR0_TX：输出端点0发送缓冲区地址
COUNT0_TX：输出端点0发送缓冲区大小
ADDR0_RX：输入端点0发送缓冲区地址
COUNT0_RX：输入端点0发送缓冲区大小
可以看到一个完整的端点描述包括：缓冲区地址+缓冲区大小。
PMA的头部为端点的描述，每个端点占8个字节，实际使用了几个端点就有几个描述头，例如使用了0、1、2这三个连续端点（这里注意是连续端点），那么PMA头部的3x8=24(十六进制的0X18)字节就是描述，倘若你使用的是0、1、3这三个端点，其中编号为2的端点虽然没使用但是占用空间，那么PMA头部的端点描述就是4x8=32字节，编号为2的端点8字节的空间就浪费了(严格来说没浪费，就是不方便使用)。
头部的端点描述之后就是各个端点的缓冲区了，例如使用了0、1、2三个端点，占用了PMA头部3x8=24字节的空间，那么这三个端点的缓冲区地址就是从PMA偏移24字节开始的，当然只要是大于24就都可以，这里就是最关键的地方了，很多人修改ST官方库实现自己USB应用时候就是没改这里的地址，导致缓冲区的使用覆盖了PMA头部的端点描述从而出错！
下面摘取一个STM32官方MSC设备的实例进行分析：
可以看到一共用到了4个端点，分别是输入端点0X80和0X81，输出端点0X00和0X01，其中0X00端点和0X80端点是供USB使用必须有的，0X81和0X01端点则是MSC设备输入输出端点。
那么一共使用了4个端点，按理来说PMA头部的端点描述大小应该是4X8=32(十六进制的0X20)字节，0X20之后的才是各个端点缓冲区，但是ST这里的却是从0X18开始，也就是说使用了三个端点，这个地方我还没有搞明白为什么，欢迎各位补充！
至于为什么0X18之后是0X58，是因为USB全速设备的最大包是64字节(十进制的0X40)，所以这里PMA的划分就是：
- 头部0X18字节为各个端点的描述
- 0X18地址开始的64字节为输出端点0的缓冲区
- 0X58地址开始的64字节为输入端点0的缓冲区
- 0X98地址开始的64字节为输出端点1的缓冲区
- 0XD8地址开始的64字节为输入端点1的缓冲区
这里注意一点，缓冲区分配好之后访问是不会溢出的，也就是说缓冲区之间完全隔离。
转载：https://blog.csdn.net/qq153471503/article/details/116053851