STM32的USB鍵盤(pán)及鼠標例程

　　0x07,

　　USB_ENDPOINT_DESCRIPTOR_TYPE,

　　0x01,

　　0x03,

　　0x0A,

　　0x00,

　　0x20,

　　};

　　// MOUSE ConfigDescriptor

　　const u8 HID_ReportDescriptor[HID_SIZE_REPORT_DESC]=

　　{

　　/************************USB鍵盤(pán)部分報告描述符**********************/

　　/*******************************************************************/

　　//這是一個(gè)全局(bType為1)條目，將用途頁(yè)選擇為普通桌面Generic Desktop Page(0x01)

　　//后面跟一字節數據(bSize為1)，后面的字節數就不注釋了，

　　//自己根據bSize來(lái)判斷。

　　0x05, 0x01, // USAGE_PAGE (Generic Desktop)

　　//這是一個(gè)局部(bType為2)條目，說(shuō)明接下來(lái)的集合用途用于鍵盤(pán)

　　0x09, 0x06, // USAGE (Keyboard)

　　//這是一個(gè)主條目(bType為0)條目，開(kāi)集合，后面跟的數據0x01表示

　　//該集合是一個(gè)應用集合。它的性質(zhì)在前面由用途頁(yè)和用途定義為

　　//普通桌面用的鍵盤(pán)。

　　0xa1, 0x01, // COLLECTION (Application)

　　//報告ID，這里定義鍵盤(pán)報告的ID為1(報告ID 0是保留的)

　　0x85, 0x01, //Report ID (1)

　　//這是一個(gè)全局條目，選擇用途頁(yè)為鍵盤(pán)(Keyboard/Keypad(0x07))

　　0x05, 0x07, // USAGE_PAGE (Keyboard/Keypad)

　　//這是一個(gè)局部條目，說(shuō)明用途的最小值為0xe0。實(shí)際上是鍵盤(pán)左Ctrl鍵。

　　//具體的用途值可在HID用途表中查看。

　　0x19, 0xe0, // USAGE_MINIMUM (Keyboard LeftControl)

　　//這是一個(gè)局部條目，說(shuō)明用途的最大值為0xe7。實(shí)際上是鍵盤(pán)右GUI鍵。

　　0x29, 0xe7, // USAGE_MAXIMUM (Keyboard Right GUI)

　　//這是一個(gè)全局條目，說(shuō)明返回的數據的邏輯值(就是我們返回的數據域的值)

　　//最小為0。因為我們這里用Bit來(lái)表示一個(gè)數據域，因此最小為0，最大為1。

　　0x15, 0x00, // LOGICAL_MINIMUM (0)

　　//這是一個(gè)全局條目，說(shuō)明邏輯值最大為1。

　　0x25, 0x01, // LOGICAL_MAXIMUM (1)

　　//這是一個(gè)全局條目，說(shuō)明數據域的數量為八個(gè)。

　　0x95, 0x08, // REPORT_COUNT (8)

　　//這是一個(gè)全局條目，說(shuō)明每個(gè)數據域的長(cháng)度為1個(gè)bit。

　　0x75, 0x01, // REPORT_SIZE (1)

　　//這是一個(gè)主條目，說(shuō)明有8個(gè)長(cháng)度為1bit的數據域(數量和長(cháng)度

　　//由前面的兩個(gè)全局條目所定義)用來(lái)做為輸入，

　　//屬性為：Data,Var,Abs。Data表示這些數據可以變動(dòng)，Var表示

　　//這些數據域是獨立的，每個(gè)域表示一個(gè)意思。Abs表示絕對值。

　　//這樣定義的結果就是，當某個(gè)域的值為1時(shí)，就表示對應的鍵按下。

　　//bit0就對應著(zhù)用途最小值0xe0，bit7對應著(zhù)用途最大值0xe7。

　　0x81, 0x02, // INPUT (Data,Var,Abs)

　　//這是一個(gè)全局條目，說(shuō)明數據域數量為1個(gè)

　　0x95, 0x01, // REPORT_COUNT (1)

　　//這是一個(gè)全局條目，說(shuō)明每個(gè)數據域的長(cháng)度為8bit。

　　0x75, 0x08, // REPORT_SIZE (8)

　　//這是一個(gè)主條目，輸入用，由前面兩個(gè)全局條目可知，長(cháng)度為8bit，

　　//數量為1個(gè)。它的屬性為常量(即返回的數據一直是0)。

　　//該字節是保留字節(保留給OEM使用)。

　　0x81, 0x03, // INPUT (Cnst,Var,Abs)

　　//這是一個(gè)全局條目。定義位域數量為6個(gè)。

　　0x95, 0x06, // REPORT_COUNT (6)

　　//這是一個(gè)全局條目。定義每個(gè)位域長(cháng)度為8bit。

　　//其實(shí)這里這個(gè)條目不要也是可以的，因為在前面已經(jīng)有一個(gè)定義

　　//長(cháng)度為8bit的全局條目了。

　　0x75, 0x08, // REPORT_SIZE (8)

　　//這是一個(gè)全局條目，定義邏輯最小值為0。

　　//同上，這里這個(gè)全局條目也是可以不要的，因為前面已經(jīng)有一個(gè)

　　//定義邏輯最小值為0的全局條目了。

　　0x15, 0x00, // LOGICAL_MINIMUM (0)

　　//這是一個(gè)全局條目，定義邏輯最大值為255。

　　0x25, 0xFF, // LOGICAL_MAXIMUM (255)

　　//這是一個(gè)全局條目，選擇用途頁(yè)為鍵盤(pán)。

　　//前面已經(jīng)選擇過(guò)用途頁(yè)為鍵盤(pán)了，所以該條目不要也可以。

　　0x05, 0x07, // USAGE_PAGE (Keyboard/Keypad)

　　//這是一個(gè)局部條目，定義用途最小值為0(0表示沒(méi)有鍵按下)

　　0x19, 0x00, // USAGE_MINIMUM (Reserved (no event indicated))

　　//這是一個(gè)局部條目，定義用途最大值為0x65

　　0x29, 0x65, // USAGE_MAXIMUM (Keyboard Application)

　　//這是一個(gè)主條目。它說(shuō)明這六個(gè)8bit的數據域是輸入用的，

　　//屬性為：Data,Ary,Abs。Data說(shuō)明數據是可以變的，Ary說(shuō)明

　　//這些數據域是一個(gè)數組，即每個(gè)8bit都可以表示某個(gè)鍵值，

　　//如果按下的鍵太多(例如超過(guò)這里定義的長(cháng)度或者鍵盤(pán)本身無(wú)法

　　//掃描出按鍵情況時(shí))，則這些數據返回全1(二進(jìn)制)，表示按鍵無(wú)效。

　　//Abs表示這些值是絕對值。

　　0x81, 0x00, // INPUT (Data,Ary,Abs)

　　//以下為輸出報告的描述

　　//邏輯最小值前面已經(jīng)有定義為0了，這里可以省略。

　　//這是一個(gè)全局條目，說(shuō)明邏輯值最大為1。

　　0x25, 0x01, // LOGICAL_MAXIMUM (1)

　　//這是一個(gè)全局條目，說(shuō)明數據域數量為5個(gè)。

　　0x95, 0x05, // REPORT_COUNT (5)

　　//這是一個(gè)全局條目，說(shuō)明數據域的長(cháng)度為1bit。

　　0x75, 0x01, // REPORT_SIZE (1)

　　//這是一個(gè)全局條目，說(shuō)明使用的用途頁(yè)為指示燈(LED)

　　0x05, 0x08, // USAGE_PAGE (LEDs)

　　//這是一個(gè)局部條目，說(shuō)明用途最小值為數字鍵盤(pán)燈。

　　0x19, 0x01, // USAGE_MINIMUM (Num Lock)

　　//這是一個(gè)局部條目，說(shuō)明用途最大值為Kana燈。

　　0x29, 0x05, // USAGE_MAXIMUM (Kana)

　　//這是一個(gè)主條目。定義輸出數據，即前面定義的5個(gè)LED。

　　0x91, 0x02, // OUTPUT (Data,Var,Abs)

　　//這是一個(gè)全局條目。定義位域數量為1個(gè)。

　　0x95, 0x01, // REPORT_COUNT (1)

　　//這是一個(gè)全局條目。定義位域長(cháng)度為3bit。

　　0x75, 0x03, // REPORT_SIZE (3)

　　//這是一個(gè)主條目，定義輸出常量，前面用了5bit，所以這里需要

　　//3個(gè)bit來(lái)湊成一字節。

　　0x91, 0x03, // OUTPUT (Cnst,Var,Abs)

　　//下面這個(gè)主條目用來(lái)關(guān)閉前面的集合。bSize為0，所以后面沒(méi)數據。

　　0xc0, // END_COLLECTION

　　//以下注釋不包括第一字節報告ID。

　　//通過(guò)上面的報告描述符的定義，我們知道返回的輸入報告具有8字節。

　　//第一字節的8個(gè)bit用來(lái)表示特殊鍵是否按下(例如Shift、Alt等鍵)。

　　//第二字節為保留值，值為常量0。第三到第八字節是一個(gè)普通鍵鍵值的

　　//數組，當沒(méi)有鍵按下時(shí)，全部6個(gè)字節值都為0。當只有一個(gè)普通鍵按下時(shí)，

　　//這六個(gè)字節中的第一字節值即為該按鍵的鍵值(具體的鍵值請看HID的

　　//用途表文檔)，當有多個(gè)普通鍵同時(shí)按下時(shí)，則同時(shí)返回這些鍵的鍵值。

　　//如果按下的鍵太多，則這六個(gè)字節都為0xFF(不能返回0x00，這樣會(huì )讓

　　//操作系統認為所有鍵都已經(jīng)釋放)。至于鍵值在數組中的先后順序是

　　//無(wú)所謂的，操作系統會(huì )負責檢查是否有新鍵按下。我們應該在中斷端點(diǎn)1

　　//中按照上面的格式返回實(shí)際的鍵盤(pán)數據。另外，報告中還定義了一個(gè)字節

　　//的輸出報告，是用來(lái)控制LED情況的。只使用了低7位，高1位是保留值0。

　　//當某位的值為1時(shí)，則表示對應的LED要點(diǎn)亮。操作系統會(huì )負責同步各個(gè)

　　//鍵盤(pán)之間的LED，例如你有兩塊鍵盤(pán)，一塊的數字鍵盤(pán)燈亮時(shí)，另一塊

　　//也會(huì )跟著(zhù)亮。鍵盤(pán)本身不需要判斷各種LED應該何時(shí)亮，它只是等待主機

　　//發(fā)送報告給它，然后根據報告值來(lái)點(diǎn)亮相應的LED。我們在端點(diǎn)1輸出中斷

　　//中讀出這1字節的輸出報告，然后對它取反(因為學(xué)習板上的LED是低電平時(shí)

　　//亮)，直接發(fā)送到LED上。這樣main函數中按鍵點(diǎn)亮LED的代碼就不需要了。