STM32的USB鍵盤及鼠標(biāo)例程

1、STM32的USB鍵盤及鼠標(biāo)例程時間：2011-07-19 21:35:05 來源： 作者：STM32的USB鍵盤及鼠標(biāo)例程通過網(wǎng)絡(luò)可以搜到很，但是在同一個設(shè)備中集成鍵盤及鼠標(biāo)的例程卻比較少見(我通過GOOGLE只搜到圈圈的基于51+D12的版本)。以下為我參考圈圈的例程做出來的集成鍵盤及鼠標(biāo)的STM32的程序。程序上除了usb_desc.c及usb_endp.c外，其它部份同單一的鍵盤鼠標(biāo)一樣。下面著重說一下usb_desc.c及usb_endp.c的不同之處。單一鍵盤鼠標(biāo)跟集成鍵盤鼠標(biāo)這區(qū)別主要是報告描述符不同。單一鍵盤鼠標(biāo)的報告描述符因只有一組報告輸入/輸出，故沒有報告ID，而集成的有兩

2、組報告(鍵盤及鼠標(biāo))，所以每一組報告都有一個報告ID加以區(qū)別。另外就是在usb_endp.c中對端點的數(shù)據(jù)發(fā)送不知道是不是我的原因，待發(fā)送數(shù)據(jù)長度有問題，原因還未找到，只能在后面增加一條設(shè)置發(fā)送數(shù)據(jù)長度的語句。(如果不加的話，PC端只會收到8位數(shù)據(jù)，盡管我程序里設(shè)置了9位數(shù)據(jù))完整的usb_desc.c文件如下：#include STM32LibUSBLibusb_lib.h#include usb_desc.h/ KM_DeviceDescriptorconst u8 HID_DeviceDescriptorHID_SIZE_DEVICE_DESC=0X12, / bLengthUSB_DE

3、VICE_DESCRIPTOR_TYPE, / bDescriptorType0x00, / bcdUSB0x02,0x00, / bDeviceClass0X00, / bDeviceSubClass0x00, / bDeviceProtocol0x40, / bMaxPacketSize400x34, / idVendor (0x0483)0x12,0x78, / idProduct = 0x57100x56,0x00, / bcdDevice rel.20.000x02,1, / index of string descriptor describing manufacturer2, /

4、 index of string descriptor describing product3, / index of string descriptor describing the device serial number0x01 / bNumConfigurations;/ USB Configuration Descriptorconst u8 HID_ConfigDescriptorHID_SIZE_CONFIG_DESC=0X09, / bLengthUSB_CONFIGURATION_DESCRIPTOR_TYPE, / bDescriptorTypeHID_SIZE_CONFI

5、G_DESC, / wTotalLength0x00,0x01, / bNumInterfaces 接口數(shù)目0x01, / bConfigurationValue set_configuration命令所需要的參數(shù)值0x00, / iConfiguration0xE0, / bmAttributes0x32, / MaxPower 100mA/*接口1配置*0x09,USB_INTERFACE_DESCRIPTOR_TYPE,0x00, / 接口編號0x00,0x02, / 端點數(shù)0x03,0x01, / 1 = boot 0 = no boot0x01, / 0 = none 1 = key

6、board 2 = mouse0, /接口描述符索引值/*HID 描述符*0x09,HID_DESCRIPTOR_TYPE,0x10,0x01,0x00,0x01,0x22,HID_SIZE_REPORT_DESC,0x00,/*端點1輸入描述*0x07,USB_ENDPOINT_DESCRIPTOR_TYPE,0x81,0x03,0x0A,0x00,0x20,/*端點1輸出描述* 0x07,USB_ENDPOINT_DESCRIPTOR_TYPE,0x01,0x03,0x0A,0x00,0x20,;/ MOUSE ConfigDescriptorconst u8 HID_ReportDesc

7、riptorHID_SIZE_REPORT_DESC=/*USB鍵盤部分報告描述符*/*/這是一個全局(bType為1)條目，將用途頁選擇為普通桌面Generic Desktop Page(0x01)/后面跟一字節(jié)數(shù)據(jù)(bSize為1)，后面的字節(jié)數(shù)就不注釋了，/自己根據(jù)bSize來判斷。0x05, 0x01, / USAGE_PAGE (Generic Desktop)/這是一個局部(bType為2)條目，說明接下來的集合用途用于鍵盤0x09, 0x06, / USAGE (Keyboard)/這是一個主條目(bType為0)條目，開集合，后面跟的數(shù)據(jù)0x01表示/該集合是一個應(yīng)用集合。它的

8、性質(zhì)在前面由用途頁和用途定義為/普通桌面用的鍵盤。0xa1, 0x01, / COLLECTION (Application)/報告ID，這里定義鍵盤報告的ID為1(報告ID 0是保留的)0x85, 0x01, /Report ID (1)/這是一個全局條目，選擇用途頁為鍵盤(Keyboard/Keypad(0x07)0x05, 0x07, / USAGE_PAGE (Keyboard/Keypad)/這是一個局部條目，說明用途的最小值為0xe0。實際上是鍵盤左Ctrl鍵。/具體的用途值可在HID用途表中查看。0x19, 0xe0, / USAGE_MINIMUM (Keyboard Left

9、Control)/這是一個局部條目，說明用途的最大值為0xe7。實際上是鍵盤右GUI鍵。0x29, 0xe7, / USAGE_MAXIMUM (Keyboard Right GUI)/這是一個全局條目，說明返回的數(shù)據(jù)的邏輯值(就是我們返回的數(shù)據(jù)域的值)/最小為0。因為我們這里用Bit來表示一個數(shù)據(jù)域，因此最小為0，最大為1。0x15, 0x00, / LOGICAL_MINIMUM (0)/這是一個全局條目，說明邏輯值最大為1。0x25, 0x01, / LOGICAL_MAXIMUM (1)/這是一個全局條目，說明數(shù)據(jù)域的數(shù)量為八個。0x95, 0x08, / REPORT_COUNT (

10、8)/這是一個全局條目，說明每個數(shù)據(jù)域的長度為1個bit。0x75, 0x01, / REPORT_SIZE (1)/這是一個主條目，說明有8個長度為1bit的數(shù)據(jù)域(數(shù)量和長度/由前面的兩個全局條目所定義)用來做為輸入，/屬性為：Data,Var,Abs。Data表示這些數(shù)據(jù)可以變動，Var表示/這些數(shù)據(jù)域是獨立的，每個域表示一個意思。Abs表示絕對值。/這樣定義的結(jié)果就是，當(dāng)某個域的值為1時，就表示對應(yīng)的鍵按下。/bit0就對應(yīng)著用途最小值0xe0，bit7對應(yīng)著用途最大值0xe7。0x81, 0x02, / INPUT (Data,Var,Abs)/這是一個全局條目，說明數(shù)據(jù)域數(shù)量為1個

11、0x95, 0x01, / REPORT_COUNT (1)/這是一個全局條目，說明每個數(shù)據(jù)域的長度為8bit。0x75, 0x08, / REPORT_SIZE (8)/這是一個主條目，輸入用，由前面兩個全局條目可知，長度為8bit，/數(shù)量為1個。它的屬性為常量(即返回的數(shù)據(jù)一直是0)。/該字節(jié)是保留字節(jié)(保留給OEM使用)。0x81, 0x03, / INPUT (Cnst,Var,Abs)/這是一個全局條目。定義位域數(shù)量為6個。0x95, 0x06, / REPORT_COUNT (6)/這是一個全局條目。定義每個位域長度為8bit。/其實這里這個條目不要也是可以的，因為在前面已經(jīng)有一個

12、定義/長度為8bit的全局條目了。0x75, 0x08, / REPORT_SIZE (8)/這是一個全局條目，定義邏輯最小值為0。/同上，這里這個全局條目也是可以不要的，因為前面已經(jīng)有一個/定義邏輯最小值為0的全局條目了。0x15, 0x00, / LOGICAL_MINIMUM (0)/這是一個全局條目，定義邏輯最大值為255。0x25, 0xFF, / LOGICAL_MAXIMUM (255)/這是一個全局條目，選擇用途頁為鍵盤。/前面已經(jīng)選擇過用途頁為鍵盤了，所以該條目不要也可以。0x05, 0x07, / USAGE_PAGE (Keyboard/Keypad)/這是一個局部條目，

13、定義用途最小值為0(0表示沒有鍵按下)0x19, 0x00, / USAGE_MINIMUM (Reserved (no event indicated)/這是一個局部條目，定義用途最大值為0x650x29, 0x65, / USAGE_MAXIMUM (Keyboard Application)/這是一個主條目。它說明這六個8bit的數(shù)據(jù)域是輸入用的，/屬性為：Data,Ary,Abs。Data說明數(shù)據(jù)是可以變的，Ary說明/這些數(shù)據(jù)域是一個數(shù)組，即每個8bit都可以表示某個鍵值，/如果按下的鍵太多(例如超過這里定義的長度或者鍵盤本身無法/掃描出按鍵情況時)，則這些數(shù)據(jù)返回全1(二進(jìn)制)，表

14、示按鍵無效。/Abs表示這些值是絕對值。0x81, 0x00, / INPUT (Data,Ary,Abs)/以下為輸出報告的描述/邏輯最小值前面已經(jīng)有定義為0了，這里可以省略。/這是一個全局條目，說明邏輯值最大為1。0x25, 0x01, / LOGICAL_MAXIMUM (1)/這是一個全局條目，說明數(shù)據(jù)域數(shù)量為5個。0x95, 0x05, / REPORT_COUNT (5)/這是一個全局條目，說明數(shù)據(jù)域的長度為1bit。0x75, 0x01, / REPORT_SIZE (1)/這是一個全局條目，說明使用的用途頁為指示燈(LED)0x05, 0x08, / USAGE_PAGE (L

15、EDs)/這是一個局部條目，說明用途最小值為數(shù)字鍵盤燈。0x19, 0x01, / USAGE_MINIMUM (Num Lock)/這是一個局部條目，說明用途最大值為Kana燈。0x29, 0x05, / USAGE_MAXIMUM (Kana)/這是一個主條目。定義輸出數(shù)據(jù)，即前面定義的5個LED。0x91, 0x02, / OUTPUT (Data,Var,Abs)/這是一個全局條目。定義位域數(shù)量為1個。0x95, 0x01, / REPORT_COUNT (1)/這是一個全局條目。定義位域長度為3bit。0x75, 0x03, / REPORT_SIZE (3)/這是一個主條目，定義輸

16、出常量，前面用了5bit，所以這里需要/3個bit來湊成一字節(jié)。0x91, 0x03, / OUTPUT (Cnst,Var,Abs)/下面這個主條目用來關(guān)閉前面的集合。bSize為0，所以后面沒數(shù)據(jù)。0xc0, / END_COLLECTION/以下注釋不包括第一字節(jié)報告ID。/通過上面的報告描述符的定義，我們知道返回的輸入報告具有8字節(jié)。/第一字節(jié)的8個bit用來表示特殊鍵是否按下(例如Shift、Alt等鍵)。/第二字節(jié)為保留值，值為常量0。第三到第八字節(jié)是一個普通鍵鍵值的/數(shù)組，當(dāng)沒有鍵按下時，全部6個字節(jié)值都為0。當(dāng)只有一個普通鍵按下時，/這六個字節(jié)中的第一字節(jié)值即為該按鍵的鍵值(具

17、體的鍵值請看HID的/用途表文檔)，當(dāng)有多個普通鍵同時按下時，則同時返回這些鍵的鍵值。/如果按下的鍵太多，則這六個字節(jié)都為0xFF(不能返回0x00，這樣會讓/操作系統(tǒng)認(rèn)為所有鍵都已經(jīng)釋放)。至于鍵值在數(shù)組中的先后順序是/無所謂的，操作系統(tǒng)會負(fù)責(zé)檢查是否有新鍵按下。我們應(yīng)該在中斷端點1/中按照上面的格式返回實際的鍵盤數(shù)據(jù)。另外，報告中還定義了一個字節(jié)/的輸出報告，是用來控制LED情況的。只使用了低7位，高1位是保留值0。/當(dāng)某位的值為1時，則表示對應(yīng)的LED要點亮。操作系統(tǒng)會負(fù)責(zé)同步各個/鍵盤之間的LED，例如你有兩塊鍵盤，一塊的數(shù)字鍵盤燈亮?xí)r，另一塊/也會跟著亮。鍵盤本身不需要判斷各種LED

18、應(yīng)該何時亮，它只是等待主機(jī)/發(fā)送報告給它，然后根據(jù)報告值來點亮相應(yīng)的LED。我們在端點1輸出中斷/中讀出這1字節(jié)的輸出報告，然后對它取反(因為學(xué)習(xí)板上的LED是低電平時/亮)，直接發(fā)送到LED上。這樣main函數(shù)中按鍵點亮LED的代碼就不需要了。/*USB鼠標(biāo)部分報告描述符*/ /*/這是一個全局(bType為1)條目，選擇用途頁為普通桌面Generic Desktop Page(0x01)0x05, 0x01, / USAGE_PAGE (Generic Desktop)/這是一個局部(bType為2)條目，說明接下來的應(yīng)用集合用途用于鼠標(biāo)0x09, 0x02, / USAGE (Mouse

19、)/這是一個主條目(bType為0)條目，開集合，后面跟的數(shù)據(jù)0x01表示/該集合是一個應(yīng)用集合。它的性質(zhì)在前面由用途頁和用途定義為/普通桌面用的鼠標(biāo)。0xa1, 0x01, / COLLECTION (Application)/報告ID，這里定義鼠標(biāo)報告的ID為20x85, 0x02, /Report ID (2)/這是一個局部條目。說明用途為指針集合0x09, 0x01, / USAGE (Pointer)/這是一個主條目，開集合，后面跟的數(shù)據(jù)0x00表示該集合是一個/物理集合，用途由前面的局部條目定義為指針集合。0xa1, 0x00, / COLLECTION (Physical)/這是

20、一個全局條目，選擇用途頁為按鍵(Button Page(0x09)0x05, 0x09, / USAGE_PAGE (Button)/這是一個局部條目，說明用途的最小值為1。實際上是鼠標(biāo)左鍵。0x19, 0x01, / USAGE_MINIMUM (Button 1)/這是一個局部條目，說明用途的最大值為3。實際上是鼠標(biāo)中鍵。0x29, 0x03, / USAGE_MAXIMUM (Button 3)/這是一個全局條目，說明返回的數(shù)據(jù)的邏輯值(就是我們返回的數(shù)據(jù)域的值啦)/最小為0。因為我們這里用Bit來表示一個數(shù)據(jù)域，因此最小為0，最大為1。0x15, 0x00, / LOGICAL_MIN

21、IMUM (0)/這是一個全局條目，說明邏輯值最大為1。0x25, 0x01, / LOGICAL_MAXIMUM (1)/這是一個全局條目，說明數(shù)據(jù)域的數(shù)量為三個。0x95, 0x03, / REPORT_COUNT (3)/這是一個全局條目，說明每個數(shù)據(jù)域的長度為1個bit。0x75, 0x01, / REPORT_SIZE (1)/這是一個主條目，說明有3個長度為1bit的數(shù)據(jù)域(數(shù)量和長度/由前面的兩個全局條目所定義)用來做為輸入，/屬性為：Data,Var,Abs。Data表示這些數(shù)據(jù)可以變動，Var表示/這些數(shù)據(jù)域是獨立的，每個域表示一個意思。Abs表示絕對值。/這樣定義的結(jié)果就是

22、，第一個數(shù)據(jù)域bit0表示按鍵1(左鍵)是否按下，/第二個數(shù)據(jù)域bit1表示按鍵2(右鍵)是否按下，第三個數(shù)據(jù)域bit2表示/按鍵3(中鍵)是否按下。0x81, 0x02, / INPUT (Data,Var,Abs)/這是一個全局條目，說明數(shù)據(jù)域數(shù)量為1個0x95, 0x01, / REPORT_COUNT (1)/這是一個全局條目，說明每個數(shù)據(jù)域的長度為5bit。0x75, 0x05, / REPORT_SIZE (5)/這是一個主條目，輸入用，由前面兩個全局條目可知，長度為5bit，/數(shù)量為1個。它的屬性為常量(即返回的數(shù)據(jù)一直是0)。/這個只是為了湊齊一個字節(jié)(前面用了3個bit)而填

23、充的一些數(shù)據(jù)/而已，所以它是沒有實際用途的。0x81, 0x03, / INPUT (Cnst,Var,Abs)/這是一個全局條目，選擇用途頁為普通桌面Generic Desktop Page(0x01)0x05, 0x01, / USAGE_PAGE (Generic Desktop)/這是一個局部條目，說明用途為X軸0x09, 0x30, / USAGE (X)/這是一個局部條目，說明用途為Y軸0x09, 0x31, / USAGE (Y)/這是一個局部條目，說明用途為滾輪0x09, 0x38, / USAGE (Wheel)/下面兩個為全局條目，說明返回的邏輯最小和最大值。/因為鼠標(biāo)指針

24、移動時，通常是用相對值來表示的，/相對值的意思就是，當(dāng)指針移動時，只發(fā)送移動量。/往右移動時，X值為正;往下移動時，Y值為正。/對于滾輪，當(dāng)滾輪往上滾時，值為正。0x15, 0x81, / LOGICAL_MINIMUM (-127)0x25, 0x7f, / LOGICAL_MAXIMUM (127)/這是一個全局條目，說明數(shù)據(jù)域的長度為8bit。0x75, 0x08, / REPORT_SIZE (8)/這是一個全局條目，說明數(shù)據(jù)域的個數(shù)為3個。0x95, 0x03, / REPORT_COUNT (3)/這是一個主條目。它說明這三個8bit的數(shù)據(jù)域是輸入用的，/屬性為：Data,Var,

25、Rel。Data說明數(shù)據(jù)是可以變的，Var說明/這些數(shù)據(jù)域是獨立的，即第一個8bit表示X軸，第二個8bit表示/Y軸，第三個8bit表示滾輪。Rel表示這些值是相對值。0x81, 0x06, / INPUT (Data,Var,Rel)/下面這兩個主條目用來關(guān)閉前面的集合用。/我們開了兩個集合，所以要關(guān)兩次。bSize為0，所以后面沒數(shù)據(jù)。0xc0, / END_COLLECTION0xc0 / END_COLLECTION/以下注釋不包括第一字節(jié)報告ID。/通過上面的報告描述符的定義，我們知道返回的輸入報告具有4字節(jié)。/第一字節(jié)的低3位用來表示按鍵是否按下的，高5位為常數(shù)0，無用。/第二字節(jié)表示X軸改的變量，第三字節(jié)表示Y軸的改變量，第四字節(jié)表示/滾輪的改變量。我們在中斷端點1中應(yīng)該要按照上面的格式返回實際的/鼠標(biāo)數(shù)據(jù)。;/ USB String Descriptorsconst u8 HID_StringLangIDHID_SIZE_STRING