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