USB描述符解析和USB_CCID描述符设置

最新推荐文章于 2024-06-24 11:06:14 发布

leumber

最新推荐文章于 2024-06-24 11:06:14 发布

阅读量3.6k

点赞数 7

分类专栏：嵌入式文章标签： usb CCID

本文链接：https://blog.csdn.net/leumber/article/details/72765902

版权

嵌入式专栏收录该内容

5 篇文章 0 订阅

订阅专栏

USB描述符解析

USB描述符信息会被存储在USB设备中，在设备枚举过程中，USB主机会向USB设备发送GetDescriptor请求，USB设备在收到这个请求之后，会将USB描述符信息返回给USB主机，USB主机分析返回来的数据，判断出该设备是哪一种USB设备，按照描述符中的一些配置信息与设备建立相应的数据通道。USB描述符信息在USB协议中有详细描述。

标准的USB设备有5种USB描述符：设备描述符，配置描述符，字符串描述符，接口描述符，端点描述符。下面详解：

1.设备描述符 一个设备只有一个设备描述符，列出这个设备的配置参数

typedef struct _USB_DEVICE_DESCRIPTOR_
{
BYTE bLength,
BYTE bDescriptorType,
WORD bcdUSB,
BYTE bDeviceClass,
BTYE bDeviceSubClass,
BYTE bDeviceProtol,
BYTE bMaxPacketSize0,
WORD idVenderI,
WORD idProduct,
WORD bcdDevice,
BYTE iManufacturer,
BYTE iProduct,
BYTE iSerialNumber,
BYTE iNumConfiguations
}USB_DEVICE_DESCRIPTOR;

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 : 端点0最大分组大小（只有8,16,32,64有效）．
idVendor : 供应商ID（由USB分配）．
idProduct : 产品ID（由厂商分配）．由供应商ID和产品ID，就可以让操作系统加载不同的驱动程序．
bcdDevice : 设备出产编码．由厂家自行设置．
iManufacturer : 厂商描述符字符串索引．索引到对应的字符串描述符.为０则表示没有.
iProduct : :产品描述符字符串索引．同上．
iSerialNumber : 设备序列号字符串索引．同上．
bNumConfigurations : 可能的配置数．指配置字符串的个数

2.配置描述符 一个设备中可以有多个配置描述符，每套配置描述符含有接口描述符，端点描述符

typedef struct _USB_CONFIGURATION_DESCRIPTOR_
{
BYTE bLength,
BYTE bDescriptorType,
WORD wTotalLength,
BYTE bNumInterfaces,
BYTE bConfigurationValue,
BYTE iConfiguration,
BYTE bmAttributes,
BYTE MaxPower
}USB_CONFIGURATION_DESCRIPTOR;

bLength: 描述符大小．固定为0x09．
bDescriptorType: 配置描述符类型．固定为0x02．
wTotalLength: 整个数据的长度．指此配置返回的配置描述符，接口描述符以及端点描述符的全部大小．
bNumInterfaces: 配置所支持的接口数．指该配置配备的接口数量，也表示该配置下接口描述符数量．
bConfigurationValue:当使用SetConfiguration和GetConfiguration请求时所指定的配置索引值
iConfiguration: 用于描述该配置字符串描述符的索引．
bmAttributes: 供电模式选择．D7:总线供电，D6:自供电，D5:远程唤醒，D4～D0:保留
MaxPower: 总线供电的USB设备的最大消耗电流．以2mA为单位．例如0x32为50*2=100mA

3.接口描述符 一个配置描述符内可以含有多个接口，数量由配置描述符决定

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:使用的端点数目．端点0除外
bInterfaceClass:类型代码（由USB分配）
bInterfaceSubClass:子类型代码（由USB分配）
bInterfaceProtocol:协议代码（由USB分配）
iInterface:字符串描述符的索引

4.端点描述符 每个接口所需要的端点及其设置，数量由配置描述符决定

typedef struct _USB_ENDPOINT_DESCRIPTOR_
{
BYTE bLength,
BYTE bDescriptorType,
BYTE bEndpointAddress,
BYTE bmAttributes,
WORD wMaxPacketSize,
BYTE bInterval
}USB_ENDPOINT_DESCRIPTOR;

bLength : 描述符大小．固定为0x07．
bDescriptorType : 接口描述符类型．固定为0x05．
bEndpointType : USB设备的端点地址．D7端点方向，对于控制端点可以忽略，1/0:IN/OUT．D6-D4，保留．D3-D0：端点号．
bmAttributes : 端点属性．D7-D2，保留．D1-D0,传输类型：00控制，01同步，02批量，03中断．
wMaxPacketSize : 本端点接收或发送的最大信息包大小．
bInterval : 轮询数据传送端点的时间间隔．对于批量传送和控制传送的端点忽略．对于同步传送的端点，必须为1，对于中断传送的端点，范围为1-255．

5.字符串描述符 字符串描述符是可选的．如果不支持字符串描述符，其设备，配置，接口描述符内的所有字符串描述符索引都必须为0，每个字符串描述符都有一个索引，USB主机会在请求时按照顺序获取对应的字符串描述符，默认0位语言字符串描述符，后边都由每个描述符内容中指定，一般1为设备厂商字符串描述符，2为产品描述符，3为设备序列号字符串描述符，4为接口描述符

typedef struct _USB_STRING_DESCRIPTION_
{
BYTE bLength,
BYTE bDescriptionType,
BYTE bString[];
}USB_STRING_DESCRIPTION;

bLength : 描述符大小．由整个字符串的长度加上bLength和bDescriptorType的长度决定．
bDescriptorType : 接口描述符类型．固定为0x03．
bString[] : Unicode编码字符串．

下边是一套USB_CCID的设备描述符、配置描述符、接口描述符、端点描述符和字符串描述符

CCID描述符配置

/*------------Descriptor of USB Device---------------------------*/ 
const UINT8 DeviceDescFS[18]= 
{     
	0x12,  //bLength          //设备描述符的字节数大小，为0x12
	0x01,  //bDescriptorType  //设备描述符类型编号，为0x01
	0x00,  //bcdUSB           //USB规范版本号（BCD码）  0x0110
	0x02,  
	0x00,  //bDeviceClass     //USB分配的设备类代码，0x01~0xfe 为标准设备类，0xff 为厂商自定义类型 0x00 不是在设备描述符中定义的，如HID
	0x00,  //bDeviceSubClass  //USB分配的设备子类代码，同上，值由USB 规定和分配的
	0x00,  //bDeviceProtocl   //USB分配的设备协议代码，同上
	CTRL_PACKET_LEN, //bMaxPacketSize0 //端点0控制传输所支持的最大数据包长度，单位字节
	0x12,  //idVendor         //厂商编号VID=0x2012
	0x20,
	0x02,  //idProduct        //产品编号PID=0x1402
	0x14,
	0x01,  //bcdDevice        //设备出厂编号bcdDevice=0x0100
	0x02,  
	0x04,  //iManufacturer    //描述厂商字符串的索引Index of Vendor
	0x1C,  //iProduct         //描述产品字符串的索引Index of Producr
	0x14,  //iSerialNumber    //描述设备序列号字符串的索引0x03;//Index of SN
	0x01   //bNumConfiguration//可能的配置数量
}; 

/*------------Descriptor of USB Configuation---------------------------*/ 
#define USB_SIZ_CONFIG_DESC		(93 + 77)
UINT8 USBD_CCID_ConfigDescriptor[] =
{
	/*Configuation Descriptor*/
	0x09,/* bLength: Configuation Descriptor size */
	0x02,/* bDescriptorType: Configuration */
	LOBYTE(USB_SIZ_CONFIG_DESC),/* wTotalLength:no of returned bytes low*/
	HIBYTE(USB_SIZ_CONFIG_DESC),,/* wTotalLength:no of returned bytes higt*/
	0x02,   /* bNumInterfaces: 2 interface */
	0x01,   /* bConfigurationValue: Configuration value */
	0x04,   /* iConfiguration: Index of string descriptor describing the configuration */
	0x80,   /* bmAttributes:bus powered */    
	0x32,   /* MaxPower 200 mA */

	/*Interface Descriptor*/
	0x09,   /* bLength: Interface Descriptor size */
	0x04,	/* bDescriptorType: Interface descriptor type*/
	0x01,   /* bInterfaceNumber: Number of Interface */		//接口号
	0x00,   /* bAlternateSetting: Alternate setting */
	0x03,   /* bNumEndpoints*/								//接口端点数量
	0x0B,   /* bInterfaceClass: Smart Card */				//接口类型：0x0B智能卡类型
	0x00,   /* bInterfaceSubClass : SCSI transparent*/
	0x00,   /* nInterfaceProtocol */
	0X05,   /* iInterface: */								//接口字符串描述符的索引

	//CCID class desc
	0x36,					//bLength                      //描述符长度， = 36H
	0x21,			 		//bDescriptorType              //描述符类型， = 21H
	0x10,0x01,				//bcdCCID                      //CCID类规范版本号  = 1.1
	0x00,					//bMaxSlotIndex                //所支持的最大插槽数 1个	
	0x03,					//bVoltageSupport  5.0V        //所支持卡的操作电压 01--5V; 02--3V; 04--1.8V 5V&3V
	0x03,0x00,0x00,0x00,	//dwProtocols  T = 0           //所支持的卡通讯协议T=0&T=1
	0xb8,0x0b,0x00,0x00,	//dwDefaultClock  3MHz         //默认卡操作时钟,以KHz为单位 3000KHz
	0xb8,0x0b,0x00,0x00,    //dwMaximumClock  3MHz         //所支持的最小时钟 3000KHz
	0x00,					//bNumClockSupported  1        //所支持的时钟数 仅支持默认时钟
	0x80,0x25,0x00,0x00,	//dwDataRate  9600bps          //默认IC卡通讯的位速率 9600
	0x80,0x25,0x00,0x00,	//dwMaxDataRate  115200bps     //所支持的与IC卡通讯的最大位速率 9600
	0x00,					//bNumDataRatesSupported  1    //所支持的位速率数 仅支持默认速率
	0xFE,0x00,0x00,0x00,	//dwMaxIFSD                    //T=1协议下的最大FSD 254
	0x00,0x00,0x00,0x00,	//dwSynchProtocols             //所支持的同步协议 当前版本为0x00000000
	0x00,0x00,0x00,0x00,	//dwMechanical                 //所支持的机械特性,00-无任何特性
	0xBA,0x00,0x02,0x00,	//dwFeatures                   //卡片特性 0x0002008A/0x0004023A
	0x80,0x01,0x00,0x00,	//dwMaxCCIDMessageLength       //最大CCID信息长度 短格式下为261+10,此处设为384
	0x00,					//bClassGetResponse            //GetReponse指令获取数据的缺省值 00
	0x00,					//bClassEnvelope               //Envelope指令缺省值 00
	0x00,0x00,				//wLcdLayout                   //液晶尺寸0x0000 没有液晶
	0x00,					//bPINSupport                  //密码支持 不支持PIN
	0x01,					//bMaxCCIDBusySlots	           //所支持的可同时操作的插槽数 1个

	/*Endpoint 1 Descriptor*/
	0x07, //bLength							//端点描述符的字节数大小
	0x05, //bDescriptorType					//端点描述符类型编号 
	EP1IN_NUMBER, //bEndpointAddress		//端点地址及输入输出属性 
	0x02, //bmAttributes					//端点的传输类型属性
	0x40, //wMaxPacketSize 					//端点收、发的最大包的大小
	0x00, 
	0x01, //bInterval	                   //主机查询端点的时间间隔	
	/*Endpoint 1 Descriptor*/
	0x07, //bLength                        //端点描述符的字节数大小
	0x05, //bDescriptorType                //端点描述符类型编号  
	EP1OUT_NUMBER, //bEndpointAddress      //端点地址及输入输出属性  
	0x02, //bmAttributes                   //端点的传输类型属性
	0x40, //wMaxPacketSize 					//端点收、发的最大包的大小
	0x00, 
	0x01,  //bInterval	                   //主机查询端点的时间间隔 
	/*Endpoint 2 Descriptor*/
	0x07, //bLength                        //端点描述符的字节数大小
	0x05, //bDescriptorType                //端点描述符类型编号  
	EP2IN_NUMBER, //bEndpointAddress       //端点地址及输入输出属性  
	0x03, //bmAttributes                   //端点的传输类型属性
	0x08, //wMaxPacketSize                 //端点收、发的最大包的大小//产生 xact error
	0x00, 
	0x0a, //bInterval	                   //主机查询端点的时间间隔

	/*Interface Descriptor*/
	0x09,	/* bLength: Interface Descriptor size */
	0x04,	/* bDescriptorType: Interface */   
	0x00,   /* bInterfaceNumber: Number of Interface */
	0x00,   /* bAlternateSetting: Alternate setting */
	0x02,   /* bNumEndpoints*/
	0x0B,   /* bInterfaceClass: Smart Card */
	0x00,   /* bInterfaceSubClass : SCSI transparent*/
	0x00,   /* nInterfaceProtocol */
	0X06,   /* iInterface: */

	0x36,
	0x21,
	0x10,0x01,
	0x00,
	0x03,
	0x03,0x00,0x00,0x00,
	0xb8,0x0b,0x00,0x00,
	0xb8,0x0b,0x00,0x00,
	0x00,
	0x80,0x25,0x00,0x00,
	0x80,0x25,0x00,0x00,
	0x00,
	0xfe,0x00,0x00,0x00,
	0x00,0x00,0x00,0x00,
	0x00,0x00,0x00,0x00,
	0xba,0x00,0x02,0x00,
	0x80,0x01,0x00,0x00,
	0x00,
	0x00,
	0x00,0x00,
	0x00,
	0x01,

	/*Endpoint 3 Descriptor*/
	0x07,			/* bLength: Endpoint Descriptor size */
	0x05,			/* bDescriptorType: Endpoint */
	EP3OUT_NUMBER,	/* bEndpointAddress: (OUT3) */
	0x02,			/* bmAttributes: Bulk */
	0x40,			/* wMaxPacketSize: */
	0x00,
	0x0A,			/* bInterval: ignore for Bulk transfer */

	/*Endpoint 3 Descriptor*/
	0x07,			/* bLength: Endpoint Descriptor size */
	0x05,			/* bDescriptorType: Endpoint */
	EP3IN_NUMBER,	/* bEndpointAddress: (IN3) */
	0x02,			/* bmAttributes: Bulk */
	0x40,			/* wMaxPacketSize: */
	0x00,
	0x0A,			/* bInterval: ignore for Bulk transfer */
	
};
/*------------Descriptor of Device String---------------------------*/ 

uint8_t USBD_LangIDDesc[0x04] =
{
	0x04,	/* bLength */      
	0x03,	/* bDescriptorType */
	0x09,	/*English(US)*/
	0x04, 
};

#define USB_SIZ_STRING_SERIAL		(10)
uint8_t USBD_StringSerial[USB_SIZ_STRING_SERIAL] =
{
	USB_SIZ_STRING_SERIAL,	/* bLength */
	0x03,  /* bDescriptorType */
	'8', 0, '0', 0, '0', 0, '0', 0
};
uint8_t USBD_Interface1Strings[USB_DESCRIPTOR_LENGTH_STRING3] = {
	sizeof(USBD_Interface1Strings),
	0x03,                                                             
	'S',0,'M',0,'A',0,'R',0,'T',0,' ',0,'C',0,'A',0,'R',0,'D',0, 
};

leumber

关注

7
点赞
踩
14

收藏

觉得还不错? 一键收藏
0
评论
USB描述符解析和USB_CCID描述符设置

USB描述符解析USB描述符信息会被存储在USB设备中，在设备枚举过程中，USB主机会向USB设备发送GetDescriptor请求，USB设备在收到这个请求之后，会将USB描述符信息返回给USB主机，USB主机分析返回来的数据，判断出该设备是哪一种USB设备，按照描述符中的一些配置信息与设备建立相应的数据通道。USB描述符信息在USB协议中有详细描述。标准的USB设备有5种USB描述
复制链接

扫一扫

专栏目录