STM32的USB鍵盤及鼠標的例程介紹

//***************端點1輸出描述***************

0x07,

USB_ENDPOINT_DESCRIPTOR_TYPE,

0x01,

0x03,

0x0A,

0x00,

0x20,

};

// MOUSE ConfigDescriptor

const u8 HID_ReportDescriptor[HID_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)用集合。它的性質(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 LeftControl)

//這是一個局部條目，說明用途的最大值為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 (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é)果就是，當某個域的值為1時，就表示對應(yīng)的鍵按下。

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

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

//這是一個全局條目，說明數(shù)據(jù)域數(shù)量為1個

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)有一個定義

//長度為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)

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

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

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

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

//這是一個主條目。它說明這六個8bit的數(shù)據(jù)域是輸入用的，

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

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

//如果按下的鍵太多(例如超過這里定義的長度或者鍵盤本身無法

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

//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 (LEDs)

//這是一個局部條目，說明用途最小值為數(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)

//這是一個主條目，定義輸出常量，前面用了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ù)組，當沒有鍵按下時，全部6個字節(jié)值都為0。當只有一個普通鍵按下時，

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

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

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

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

//無所謂的，操作系統(tǒng)會負責檢查是否有新鍵按下。我們應(yīng)該在中斷端點1

//中按照上面的格式返回實際的鍵盤數(shù)據(jù)。另外，報告中還定義了一個字節(jié)

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

//當某位的值為1時，則表示對應(yīng)的LED要點亮。操作系統(tǒng)會負責同步各個

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

//也會跟著亮。鍵盤本身不需要判斷各種LED應(yīng)該何時亮，它只是等待主機

//發(fā)送報告給它，然后根據(jù)報告值來點亮相應(yīng)的LED。我們在端點1輸出中斷

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

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