STM32F030R8T6 學(xué)習筆記之USB虛擬串口描述符簡介
發(fā)布時間：2018/11/6
escriptor即描述符，是一個完整的數(shù)據(jù)結(jié)構(gòu)，可以通過C語言等編程實現(xiàn)，并存儲在USB設(shè)備中，用于描述一個USB設(shè)備的所有屬性，USB主機是通過一系列命令來要求設(shè)備發(fā)送這些信息的。它的作用就是通過如問答節(jié)中的命令***作來給主機傳遞信息，從而讓主機知道設(shè)備具有什么功能、屬于哪一類設(shè)備、要占用多少帶寬、使用哪類傳輸方式及數(shù)據(jù)量的大小，只有主機確定了這些信息之后，設(shè)備才能真正開始工作，所以描述符也是十分重要的部分，要好好掌握。標準的描述符有5種，USB為這些描述符定義了編號：
1——設(shè)備描述符
2——配置描述符
3——字符描述符
4——接口描述符
5——端點描述符
上面的描述符之間有一定的關(guān)系，一個設(shè)備只有一個設(shè)備描述符，而一個設(shè)備描述符可以包含多個配置描述符，而一個配置描述符可以包含多個接口描述符，一個接口使用了幾個端點，就有幾個端點描述符。這間描述符是用一定的字段構(gòu)成的，分別如下說明：
1、設(shè)備描述符
struct _DEVICE_DEscriptOR_STRUCT
{
BYTE bLength; //設(shè)備描述符的字節(jié)數(shù)大小，為0x12
BYTE bDescriptorType; //描述符類型編號，為0x01
WORD bcdUSB; //USB版本號
BYTE bDeviceClass; //USB分配的設(shè)備類代碼，0x01~0xfe為標準設(shè)備類，0xff為廠商自定義類型
//0x00不是在設(shè)備描述符中定義的，如HID
BYTE bDeviceSubClass; //usb分配的子類代碼，同上，值由USB規(guī)定和分配的
BYTE bDeviceProtocl; //USB分配的設(shè)備協(xié)議代碼，同上
BYTE bMaxPacketSize0; //端點0的最大包的大小
WORD idVendor; //廠商編號
WORD idProduct; //產(chǎn)品編號
WORD bcdDevice; //設(shè)備出廠編號
BYTE iManufacturer; //描述廠商字符串的索引
BYTE iProduct; //描述產(chǎn)品字符串的索引
BYTE iSerialNumber; //描述設(shè)備序列號字符串的索引
BYTE bNumConfiguration; //可能的配置數(shù)量
}
2、配置描述符
struct _CONFIGURATION_DEscriptOR_STRUCT
{
BYTE bLength; //設(shè)備描述符的字節(jié)數(shù)大小，為0x12
BYTE bDescriptorType; //描述符類型編號，為0x01
WORD wTotalLength; //配置所返回的所有數(shù)量的大小
BYTE bNumInterface; //此配置所支持的接口數(shù)量
BYTE bConfigurationVale; //Set_Configuration命令需要的參數(shù)值
BYTE iConfiguration; //描述該配置的字符串的索引值
BYTE bmAttribute; //供電模式的選擇
BYTE MaxPower; //設(shè)備從總線提取的最大電流
}
3、字符描述符
struct _STRING_DEscriptOR_STRUCT
{
BYTE bLength; //設(shè)備描述符的字節(jié)數(shù)大小，為0x12
BYTE bDescriptorType; //描述符類型編號，為0x01
BYTE SomeDescriptor[36]; //UNICODE編碼的字符串
}
4、接口描述符
struct _INTERFACE_DEscriptOR_STRUCT
{
BYTE bLength; //設(shè)備描述符的字節(jié)數(shù)大小，為0x12
BYTE bDescriptorType; //描述符類型編號，為0x01
BYTE bInterfaceNunber; //接口的編號
BYTE bAlternateSetting;//備用的接口描述符編號
BYTE bNumEndpoints; //該接口使用端點數(shù)，不包括端點0
BYTE bInterfaceClass; //接口類型
BYTE bInterfaceSubClass;//接口子類型
BYTE bInterfaceProtocol;//接口所遵循的協(xié)議
BYTE iInterface; //描述該接口的字符串索引值
}
5、端點描述符
struct _ENDPOIN_DEscriptOR_STRUCT
{
BYTE bLength; //設(shè)備描述符的字節(jié)數(shù)大小，為0x12
BYTE bDescriptorType; //描述符類型編號，為0x01
BYTE bEndpointAddress; //端點地址及輸入輸出屬性
BYTE bmAttribute; //端點的傳輸類型屬性
WORD wMaxPacketSize; //端點收、發(fā)的最大包的大小
BYTE bInterval; //主機查詢端點的時間間隔
}
具體分析如下：
1、描述設(shè)備類型Device Descriptor
包含了設(shè)備名稱,類別,生產(chǎn)廠家等等信息,通過得到的這些信息Host會去找到合適的設(shè)備驅(qū)動程序在主機上加載驅(qū)動。
/* USB Standard Device Descriptor */
const u8 Virtual_Com_Port_DeviceDescriptor[] =
{
0x12, /* bLength */ //USB設(shè)備描述符的總長度固定為18個字節(jié)，因此為12H
USB_DEVICE_DESCRIPTOR_TYPE, /* bDescriptorType */ //USB設(shè)備描述符的類型值，固定為01H
0x00, //USB遵循的規(guī)范版本號，USB2.0; 0xXXYZ,XX為主版本號，Y為次版本號，Z為子次版本號
0x02, /* bcdUSB = 2.00 */
0x02, /* bDeviceClass: CDC */ //USB所遵循的標準設(shè)備類。0表示設(shè)備的接口相互獨立，分別屬于不同的設(shè)備類；
//1~FEH之間表示USB協(xié)議中定義的某個類。03H表示HID類，02H表示CDC類。
//FFH表示供應(yīng)商自定義的設(shè)備類
0x00, /* bDeviceSubClass */ //USB設(shè)備所屬的標準設(shè)備子類。對于顯示設(shè)備類(04H)，包含3個子類，
//子類代碼01H表示CRT顯示器，02H表示平面顯示器，03H表示3D顯示器。
//bDeviceClass為0時，該值為0；該值為FFH時，表示供應(yīng)商自定義的設(shè)備子類
0x00, /* bDeviceProtocol */ //采用的設(shè)備類協(xié)議。該值為FFH時表示設(shè)備類協(xié)議由供應(yīng)商自定義
0x40, /* bMaxPacketSize0 */ //端點0所支持最大數(shù)據(jù)包長度（字節(jié)），低速為8，全速為8,16,32或64，高速為64
0x83, //設(shè)備供應(yīng)商id，使主機為其加載合適驅(qū)動
0x04, /* idVendor = 0x0483 */
0x40, //產(chǎn)品id，用于區(qū)分不同的usb設(shè)備
0x57, /* idProduct = 0x7540 */
0x00, //設(shè)備版本號,幫助主機加載合適驅(qū)動
0x01, /* bcdDevice = 1.00 */
1, /* Index of string descriptor describing manufacturer */ //若沒有，可為0
2, /* Index of string descriptor describing product */ //若沒有，可為0
3, /* Index of string descriptor describing the device’s serial number */ //若沒有，可為0
0x01 /* bNumConfigurations */ //USB設(shè)備所支持的配置數(shù)
};
2、配置描述符Config Descriptor
包含了接口類型，最大功耗(電流)，供電方式等等信息，事實上這個配置描述項不僅僅是剛才說的這些作用，更多地，它需要通知主機設(shè)備所使用的ENDpoint的情況，使用的類驅(qū)動類型，等等信息
const u8 Virtual_Com_Port_ConfigDescriptor[] =
{
/*Configuation Descriptor*/
0x09, /* bLength: Configuation Descriptor size */ //配置描述符的長度，固定為9字節(jié)，09H
USB_CONFIGURATION_DESCRIPTOR_TYPE, /* bDescriptorType: Configuration */ //配置描述符類型，固定位02H
VIRTUAL_COM_PORT_SIZ_CONFIG_DESC, /* wTotalLength:no of returned bytes */ //配置信息總長度，配置描述符、接口描述符、端點描述符長度總和
0x00,
0x02, /* bNumInterfaces: 2 interface */ //所支持的接口數(shù), 最小值為1
0x01, /* bConfigurationValue: Configuration value */ //USB設(shè)備的配置值
0x00, /* iConfiguration: Index of string descriptor describing the configuration */ //字符串描述符索引，若沒有，可為0
0xC0, /* bmAttributes: self powered */ //配置特性，可按位尋址，第六位置1表示用總線電源，第五位置1表示支持遠程喚醒，其他字段保留
//一般0~4位置0，第7位置1
0x00, /* MaxPower 0 mA */ //USB設(shè)備運行時所支持的最大電流，2mA為單位
/*Interface Descriptor*/
0x09, /* bLength: Interface Descriptor size */ //接口描述符長度，固定為9字節(jié)，09H
USB_INTERFACE_DESCRIPTOR_TYPE, /* bDescriptorType: Interface */ //接口描述符的類型值，固定位04H
/* Interface descriptor type */
0x00, /* bInterfaceNumber: Number of Interface */ //USB接口的接口號
0x00, /* bAlternateSetting: Alternate setting */ //USB接口的可替換設(shè)置值
0x01, /* bNumEndpoints: One endpoints used */ //USB接口所使用的接口總數(shù)
0x02,
