STM32 keyboard USB鍵盤功能的實(shí)現(xiàn)

下面編寫下USB鍵盤的程序，依然在CustomHID工程上修改。

依舊最先修改的是usb_desc.c文件。我們從設(shè)備描述符開始講述。

設(shè)備描述符需要修改下bMaxPacketSize(最大包長(zhǎng)度)域?yàn)?x08，因?yàn)楸槐敬蔚墓こ套畲笸ㄓ嶉L(zhǎng)度就是8字節(jié)，正好符合USB規(guī)范，所以這里改成0x08，還要注意在usb_prop.c的DEVICE_PROP Device_Property結(jié)構(gòu)體里注冊(cè)的最大長(zhǎng)度也要是0x08，與設(shè)備描述符的要相同(我們?cè)谙挛恼f(shuō)到)。這里最好還要修改下PID和VID的域的值，以防該P(yáng)ID和VID對(duì)應(yīng)的設(shè)備已經(jīng)在電腦里有了驅(qū)動(dòng)而導(dǎo)致功能不正常。

/* USB標(biāo)準(zhǔn)設(shè)備描述符*/

const uint8_t Keyboard_DeviceDescriptor[KEYBOARD_SIZ_DEVICE_DESC] =

{

0x12, /*bLength：長(zhǎng)度，設(shè)備描述符的長(zhǎng)度為18字節(jié)*/

USB_DEVICE_DESCRIPTOR_TYPE, /*bDescriptorType：類型，設(shè)備描述符的編號(hào)是0x01*/

0x00, /*bcdUSB：所使用的USB版本為2.0*/

0x02,

0x00, /*bDeviceClass：設(shè)備所使用的類代碼*/

0x00, /*bDeviceSubClass：設(shè)備所使用的子類代碼*/

0x00, /*bDeviceProtocol：設(shè)備所使用的協(xié)議*/

0x08, /*bMaxPacketSize：最大包長(zhǎng)度為8字節(jié)*/

0x78, /*idVendor：廠商ID為0x7788*/

0x67,

0x12, /*idProduct：產(chǎn)品ID為0x1122*/

0x01,

0x00, /*bcdDevice：設(shè)備的版本號(hào)為2.00*/

0x02,

1, /*iManufacturer:廠商字符串的索引*/

2, /*iProduct：產(chǎn)品字符串的索引*/

3, /*iSerialNumber：設(shè)備的序列號(hào)字符串索引*/

0x01 /*bNumConfiguration：設(shè)備有1種配置*/

}; /* keyboard設(shè)備描述符 */

接下去修改下配置描述符。找到接口的描述符的bNumEndpoints(該接口所使用的端點(diǎn)數(shù))域，不用修改,但需要提下，還是0x02，表示使用2個(gè)端點(diǎn)。修改下接口描述符的nInterfaceProtocol (該接口使用的協(xié)議)域?yàn)?x01，表示是鍵盤。在輸入端點(diǎn)描述符中端點(diǎn)設(shè)置端點(diǎn)1為為中斷傳輸?shù)妮斎攵它c(diǎn)，設(shè)置 wMaxPacketSize:(該端點(diǎn)支持的最大包長(zhǎng)度)域的值為0x08，因?yàn)楸敬捂I盤的工程需要向USB主機(jī)發(fā)送8字節(jié)。在輸出端點(diǎn)描述符設(shè)置端點(diǎn)1為中斷傳輸?shù)妮敵龆它c(diǎn)，設(shè)置為中斷傳輸設(shè)置 wMaxPacketSize:(該端點(diǎn)支持的最大包長(zhǎng)度)域的值為0x01，因?yàn)閁SB主機(jī)只會(huì)向USB從設(shè)備發(fā)送1個(gè)字節(jié)。

/* USB配置描述符集合(配置、接口、端點(diǎn)、類、廠商)(Configuration, Interface, Endpoint, Class, Vendor */

const uint8_t Keyboard_ConfigDescriptor[KEYBOARD_SIZ_CONFIG_DESC] =

{

0x09, /*bLength：長(zhǎng)度，設(shè)備字符串的長(zhǎng)度為9字節(jié)*/

USB_CONFIGURATION_DESCRIPTOR_TYPE, /*bDescriptorType：類型，配置描述符的類型編號(hào)為0x2*/

KEYBOARD_SIZ_CONFIG_DESC, /*wTotalLength：配置描述符的總長(zhǎng)度為41字節(jié)*/

0x00,

0x01, /*bNumInterfaces：配置所支持的接口數(shù)量1個(gè)*/

0x01, /*bConfigurationValue：該配置的值*/

0x00, /*iConfiguration：該配置的字符串的索引值，該值為0表示沒(méi)有字符串*/

0xC0, /* bmAttributes:設(shè)備的一些特性，0xc0表示自供電，不支持遠(yuǎn)程喚醒

D7:保留必須為1，D6:是否自供電，D5：是否支持遠(yuǎn)程喚醒，D4~D0：保留設(shè)置為0*/

0x32, /*從總線上獲得的最大電流為100mA */

// 0x96, /*MaxPower：設(shè)備需要從總線上獲取多少電流，單位為2mA，0x96表示300mA*/

/************** 接口描述符****************/

/* 09 */

0x09, /*bLength：長(zhǎng)度，接口描述符的長(zhǎng)度為9字節(jié) */

USB_INTERFACE_DESCRIPTOR_TYPE,/* bDescriptorType：接口描述符的類型為0x4 */

0x00, /*bInterfaceNumber：該接口的編號(hào)*/

0x00, /*bAlternateSetting：該接口的備用編號(hào) */

0x02, /*bNumEndpoints：該接口所使用的端點(diǎn)數(shù)*/

0x03, /*bInterfaceClass該接口所使用的類為HID*/

0x01, /*bInterfaceSubClass：該接口所用的子類 1=BOOT, 0=no boot */

0x01, /*nInterfaceProtocol :該接口使用的協(xié)議0=none, 1=keyboard, 2=mouse */

0, /*iInterface: 該接口字符串的索引 */

/*****************HID描述符 ********************/

/* 18 */

0x09, /*bLength: HID描述符的長(zhǎng)度為9字節(jié) */

HID_DESCRIPTOR_TYPE, /* bDescriptorType: HID的描述符類型為0x21 */

0x10, /*bcdHID: HID協(xié)議的版本為1.1 */

0x01,

0x21, /*bCountryCode: 國(guó)家代號(hào) */

0x01, /*bNumDescriptors: 下級(jí)描述符的數(shù)量*/

0x22, /*bDescriptorType：下級(jí)描述符的類型*/

KEYBOARD_SIZ_REPORT_DESC,/* wItemLength: 下一集描述符的長(zhǎng)度*/

0x00,

/********************輸入端點(diǎn)描述符******************/

/* 27 */

0x07, /* bLength: 端點(diǎn)描述符的長(zhǎng)度為7字節(jié)*/

USB_ENDPOINT_DESCRIPTOR_TYPE, /* bDescriptorType: 端點(diǎn)描述符的類型為0x05*/

0x81, /* bEndpointAddress: 該端點(diǎn)(輸入)的地址,D7:0(OUT),1(IN),D6~D4:保留,D3~D0:端點(diǎn)號(hào)*/

0x03, /* bmAttributes: 端點(diǎn)的屬性為為中斷端點(diǎn).

D0~D1表示傳輸類型:0(控制傳輸),1(等時(shí)傳輸),2(批量傳輸),3(中斷傳輸)

非等時(shí)傳輸端點(diǎn):D2~D7:保留為0

等時(shí)傳輸端點(diǎn)：

D2~D3表示同步的類型:0(無(wú)同步),1(異步),2(適配),3(同步)

D4~D5表示用途:0(數(shù)據(jù)端點(diǎn)),1(反饋端點(diǎn)),2(暗含反饋的數(shù)據(jù)端點(diǎn)),3(保留)，D6~D7:保留,*/

0x08, /* wMaxPacketSize: 該端點(diǎn)支持的最大包長(zhǎng)度為8字節(jié)*/

0x00,

0x0A, /* bInterval: 輪詢間隔(32ms) */

/********************輸出端點(diǎn)描述符*******************/

/* 34 */

0x07, /* bLength: 端點(diǎn)描述符的長(zhǎng)度為7字節(jié)*/

USB_ENDPOINT_DESCRIPTOR_TYPE, /* bDescriptorType: 端點(diǎn)描述符的類型為0x05*/

0x01, /* bEndpointAddress: 該端點(diǎn)(輸入)的地址,D7:0(OUT),1(IN),D6~D4:保留,D3~D0:端點(diǎn)號(hào)*/

0x03, /* bmAttributes: 端點(diǎn)的屬性為為中斷端點(diǎn).

D0~D1表示傳輸類型:0(控制傳輸),1(等時(shí)傳輸),2(批量傳輸),3(中斷傳輸)

非等時(shí)傳輸端點(diǎn):D2~D7:保留為0

等時(shí)傳輸端點(diǎn)：

D2~D3表示同步的類型:0(無(wú)同步),1(異步),2(適配),3(同步)

D4~D5表示用途:0(數(shù)據(jù)端點(diǎn)),1(反饋端點(diǎn)),2(暗含反饋的數(shù)據(jù)端點(diǎn)),3(保留)，D6~D7:保留,*/

0x01, /* wMaxPacketSize: 該端點(diǎn)支持的最大包長(zhǎng)度為字節(jié)*/

0x00,

0x0A, /* bInterval: 輪詢間隔(32ms) */

/* 41 */

};

講到報(bào)告描述符，得將報(bào)告描述符的整個(gè)替換掉。該報(bào)告描述符定義了8字節(jié)的輸入域，第一個(gè)字節(jié)表示特殊件是否按下，鍵盤的特殊鍵包括:ctrl,shift,alt鍵等，該字節(jié)D0表示Ctrl鍵，D1表示Shift鍵，D2表示Alt鍵，其他位保留。第二個(gè)字節(jié)保留，固定值為0。第三個(gè)字節(jié)到第八個(gè)字節(jié)用來(lái)保存按鍵值，如果只有一個(gè)按鍵按下，則按鍵值保存在第三個(gè)字節(jié)，如果有兩個(gè)或兩個(gè)以上的按鍵按下，則依次保存在從第三字節(jié)開始的字節(jié)中，當(dāng)然最多只能6個(gè)按鍵同時(shí)按下，超過(guò)6個(gè)鍵值，則不響應(yīng)。報(bào)告描述符還定義了一個(gè)字節(jié)的輸出域，該字節(jié)是是用來(lái)控制LED燈的，我們都知道鍵盤的上有幾個(gè)LED燈，比如說(shuō)大小寫鍵的LED燈等，該字節(jié)的定義:D0:Num Lock D1:Cap Lock D2:Scroll Lock D3:Compose D4:Kana，由于我一直用筆記本電腦的鍵盤，所以我也只認(rèn)識(shí)前三個(gè)鍵。在這個(gè)工程，我只做了Ctrl鍵、Shift鍵、Num Lock鍵，以及A鍵。

/* HID的報(bào)告描述符*/

/*定義了8字