STM32 USB相关知识扫盲

1万 · 2021-7-4 16:07

1、基础知识

等级划分：

接口类型：

STM32基础型(F1系列)所带的USB是全速。

1万 · 2021-7-4 16:08

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+有一个上拉电阻，而且是必须有的：

1万 · 2021-7-4 16:08

3、USB设备分类

1万 · 2021-7-4 16:08

看一个CDC虚拟串口的设备分类：

1万 · 2021-7-4 16:08

在看一个MSC的（模拟U盘）：

不同的类有不同的用途；不同的应用场合对应不同的产品形态；不同的产品形态可能会有自己特殊的描述符，比如： HID类有报告描述符、CDC类有ACM、Union描述符等。

1万 · 2021-7-4 16:09

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（输入端口）
{

}
}
}

1万 · 2021-7-4 16:09

4.1 设备描述符

每个USB设备都必须且只有一个设备描述符，摘取一下STM32的MSC设备里的实例代码：

1万 · 2021-7-4 16:09

每个字段的含义：

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 ：可能的配置数．指配置字符串的个数。

1万 · 2021-7-4 16:09

4.2 配置描述符

配置描述符定义了设备的配置信息，一个设备可以有多个配置描述符。摘一个STM32的MSC设备的配置描述符：

1万 · 2021-7-4 16:10

用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为单位

1万 · 2021-7-4 16:10

4.3 接口描述符

接口描述符说明了接口所提供的配置，一个配置所拥有的接口数量通过配置描述符的bNumInterfaces决定，摘取STM32的MSC设备类的接口描述符：

1万 · 2021-7-4 16:10

用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 : 字符串描述符的索引

1万 · 2021-7-4 16:11

4.4 端点描述符

USB设备中的每个端点都有自己的端点描述符，由接口描述符中的bNumEndpoint决定其数量。摘取STM32的MSC设备类的端口描述符：

1万 · 2021-7-4 16:11

用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

1万 · 2021-7-4 16:11

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编码字符串

1万 · 2021-7-4 16:12

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       //描述字符串索引
}

1万 · 2021-7-4 16:12

以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
{

}
}
}
}

1万 · 2021-7-4 16:12

5、STM32-USB详解

这个512字节SRAM叫做Packet Buffer Memory Area(简称PMA)，这个很重要，后面会详细讲解。

1万 · 2021-7-4 16:13

根据描述可以，一共有8个端点，16个寄存器，一个端点关联两个寄存器，所以我们可以将他们规划为8个输入端点(0x80-0X87)+8个输出端点(0X00-0X07)。

1万 · 2021-7-4 16:14

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头部的端点描述从而出错！