等级划分:
接口类型:
STM32基础型(F1系列)所带的USB是全速。
USB的通信都是由主机发起的,这一点与IIC协议是类似的。
USB使用差分传输模式,有两条数据线,分别是:
剩下的就是电源线(5V-Vbus)和地线(GND)。
主机的D+和D-都接有15K下拉电阻。
因此,主机就可以根据检测到自己的D+为高还是D-为高,从而判断接入的设备是一个全速还是低速设备。
所以你可以看到STM32板子上的USB口D+有一个上拉电阻,而且是必须有的:
看一个CDC虚拟串口的设备分类:
在看一个MSC的(模拟U盘):
不同的类有不同的用途;不同的应用场合对应不同的产品形态;不同的产品形态可能会有自己特殊的描述符,比如:HID类有报告描述符、CDC类有ACM、Union描述符等。
以STM32里的MSC设备为例,MSC类所需要的描述符有:设备描述符+配置描述符+接口描述符(数量由配置描述符里的bNumInterfaces字段决定)+端点描述符(数量由配置描述符里的bNumEndpoints决定),所以MSC类结构就是这样的:
配置描述符{ 接口描述符1 { 端点描述符1 { } 端点描述符2 { } }}
而CDC类是这样的:
配置描述符{ 接口描述符1(通信接口) { 其他描述符(特殊描述符) { } 端点描述符(命令端点) { } } 接口描述符2(数据接口) { 端点描述符1(输出端口) { } 端点描述符2(输入端口) { } }}
每个USB设备都必须且只有一个设备描述符,摘取一下STM32的MSC设备里的实例代码:
每个字段的含义:
配置描述符定义了设备的配置信息,一个设备可以有多个配置描述符。摘一个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;
每个字段含义如下:
接口描述符说明了接口所提供的配置,一个配置所拥有的接口数量通过配置描述符的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;
每个字段含义如下:
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;
每个字段含义如下:
字符串描述符是可选的,如果不支持字符串描述符,其设备描述符、配置描述符、接口描述符内的所有字符串描述符索引都必须为0。
字符串描述符结构如下:
typedef struct _USB_STRING_DEscriptION_{ BYTE bLength, BYTE bDescriptionType, BYTE bString[1];}USB_STRING_DEscriptION;
各个字段含义:
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(通信接口) { 其他描述符(特殊描述符) { } 端点描述符(命令端点) { } } 接口描述符2(数据接口) { 端点描述符1(输出端口) { } 端点描述符2(输入端口) { } } } IAD描述符(MSC) { 接口描述符1 { 端点描述符1 { } 端点描述符2 { } } }}
这个512字节SRAM叫做Packet Buffer Memory Area(简称PMA),这个很重要,后面会详细讲解。
根据描述可以,一共有8个端点,16个寄存器,一个端点关联两个寄存器,所以我们可以将他们规划为8个输入端点(0x80-0x87)+8个输出端点(0x00-0x07)。
先说一下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的划分就是:
这里注意一点,缓冲区分配好之后访问是不会溢出的,也就是说缓冲区之间完全隔离。