?
STM32的USB鍵盤(pán)及鼠標(biāo)例程通過(guò)網(wǎng)絡(luò)可以搜到很,但是在同一個(gè)設(shè)備中集成鍵盤(pán)及鼠標(biāo)的例程卻比較少見(jiàn)(我通過(guò)GOOGLE只搜到圈圈的基于51+D12的版本)。以下為我參考圈圈的例程做出來(lái)的集成鍵盤(pán)及鼠標(biāo)的STM32的程序。
程序上除了usb_desc.c及usb_endp.c外,其它部份同單一的鍵盤(pán)鼠標(biāo)一樣。下面著重說(shuō)一下usb_desc.c及usb_endp.c的不同之處。
單一鍵盤(pán)鼠標(biāo)跟集成鍵盤(pán)鼠標(biāo)這區(qū)別主要是報(bào)告描述符不同。單一鍵盤(pán)鼠標(biāo)的報(bào)告描述符因只有一組報(bào)告輸入/輸出,故沒(méi)有報(bào)告ID,而集成的有兩組報(bào)告(鍵盤(pán)及鼠標(biāo)),所以每一組報(bào)告都有一個(gè)報(bào)告ID加以區(qū)別。
另外就是在usb_endp.c中對(duì)端點(diǎn)的數(shù)據(jù)發(fā)送不知道是不是我的原因,待發(fā)送數(shù)據(jù)長(zhǎng)度有問(wèn)題,原因還未找到,只能在后面增加一條設(shè)置發(fā)送數(shù)據(jù)長(zhǎng)度的語(yǔ)句。(如果不加的話,PC端只會(huì)收到8位數(shù)據(jù),盡管我程序里設(shè)置了9位數(shù)據(jù))
完整的usb_desc.c文件如下:
#include "STM32Lib\\USBLib\\usb_lib.h"
#include "usb_desc.h"
// KM_DeviceDescriptor
const u8 HID_DeviceDescriptor[HID_SIZE_DEVICE_DESC]=
{
0X12, // bLength
USB_DEVICE_DESCRIPTOR_TYPE, // bDescriptorType
0x00, // bcdUSB
0x02,
0x00, // bDeviceClass
0X00, // bDeviceSubClass
0x00, // bDeviceProtocol
0x40, // bMaxPacketSize40
0x34, // idVendor (0x0483)
0x12,
0x78, // idProduct = 0x5710
0x56,
0x00, // bcdDevice rel.20.00
0x02,
1, // index of string descriptor describing manufacturer
2, // index of string descriptor describing product
3, // index of string descriptor describing the device serial number
0x01 // bNumConfigurations
};
// USB Configuration Descriptor
const u8 HID_ConfigDescriptor[HID_SIZE_CONFIG_DESC]=
{
0X09, // bLength
USB_CONFIGURATION_DESCRIPTOR_TYPE, // bDescriptorType
HID_SIZE_CONFIG_DESC, // wTotalLength
0x00,
0x01, // bNumInterfaces 接口數(shù)目
0x01, // bConfigurationValue set_configuration命令所需要的參數(shù)值
0x00, // iConfiguration
0xE0, // bmAttributes
0x32, // MaxPower 100mA
//***************接口1配置***************
0x09,
USB_INTERFACE_DESCRIPTOR_TYPE,
0x00, // 接口編號(hào)
0x00,
0x02, // 端點(diǎn)數(shù)
0x03,
0x01, // 1 = boot 0 = no boot
0x01, // 0 = none 1 = keyboard 2 = mouse
0, //接口描述符索引值
//***************HID 描述符****************
0x09,
HID_DESCRIPTOR_TYPE,
0x10,
0x01,
0x00,
0x01,
0x22,
HID_SIZE_REPORT_DESC,
0x00,
//***************端點(diǎn)1輸入描述***************
0x07,
USB_ENDPOINT_DESCRIPTOR_TYPE,
0x81,
0x03,
0x0A,
0x00,
0x20,
//***************端點(diǎn)1輸出描述***************
0x07,
USB_ENDPOINT_DESCRIPTOR_TYPE,
0x01,
0x03,
0x0A,
0x00,
0x20,
};
// MOUSE ConfigDescriptor
const u8 HID_ReportDescriptor[HID_SIZE_REPORT_DESC]=
{
/************************USB鍵盤(pán)部分報(bào)告描述符**********************/
/*******************************************************************/
//這是一個(gè)全局(bType為1)條目,將用途頁(yè)選擇為普通桌面Generic Desktop Page(0x01)
//后面跟一字節(jié)數(shù)據(jù)(bSize為1),后面的字節(jié)數(shù)就不注釋了,
//自己根據(jù)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)集合,后面跟的數(shù)據(jù)0x01表示
//該集合是一個(gè)應(yīng)用集合。它的性質(zhì)在前面由用途頁(yè)和用途定義為
//普通桌面用的鍵盤(pán)。
0xa1, 0x01, // COLLECTION (Application)
//報(bào)告ID,這里定義鍵盤(pán)報(bào)告的ID為1(報(bào)告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ō)明返回的數(shù)據(jù)的邏輯值(就是我們返回的數(shù)據(jù)域的值)
//最小為0。因?yàn)槲覀冞@里用Bit來(lái)表示一個(gè)數(shù)據(jù)域,因此最小為0,最大為1。
0x15, 0x00, // LOGICAL_MINIMUM (0)
//這是一個(gè)全局條目,說(shuō)明邏輯值最大為1。
0x25, 0x01, // LOGICAL_MAXIMUM (1)
//這是一個(gè)全局條目,說(shuō)明數(shù)據(jù)域的數(shù)量為八個(gè)。
0x95, 0x08, // REPORT_COUNT (8)
//這是一個(gè)全局條目,說(shuō)明每個(gè)數(shù)據(jù)域的長(zhǎng)度為1個(gè)bit。
0x75, 0x01, // REPORT_SIZE (1)
//這是一個(gè)主條目,說(shuō)明有8個(gè)長(zhǎng)度為1bit的數(shù)據(jù)域(數(shù)量和長(zhǎng)度
//由前面的兩個(gè)全局條目所定義)用來(lái)做為輸入,
//屬性為:Data,Var,Abs。Data表示這些數(shù)據(jù)可以變動(dòng),Var表示
//這些數(shù)據(jù)域是獨(dú)立的,每個(gè)域表示一個(gè)意思。Abs表示絕對(duì)值。
//這樣定義的結(jié)果就是,當(dāng)某個(gè)域的值為1時(shí),就表示對(duì)應(yīng)的鍵按下。
//bit0就對(duì)應(yīng)著用途最小值0xe0,bit7對(duì)應(yīng)著用途最大值0xe7。
0x81, 0x02, // INPUT (Data,Var,Abs)
//這是一個(gè)全局條目,說(shuō)明數(shù)據(jù)域數(shù)量為1個(gè)
0x95, 0x01, // REPORT_COUNT (1)
//這是一個(gè)全局條目,說(shuō)明每個(gè)數(shù)據(jù)域的長(zhǎng)度為8bit。
0x75, 0x08, // REPORT_SIZE (8)
//這是一個(gè)主條目,輸入用,由前面兩個(gè)全局條目可知,長(zhǎng)度為8bit,
//數(shù)量為1個(gè)。它的屬性為常量(即返回的數(shù)據(jù)一直是0)。
//該字節(jié)是保留字節(jié)(保留給OEM使用)。
0x81, 0x03, // INPUT (Cnst,Var,Abs)
//這是一個(gè)全局條目。定義位域數(shù)量為6個(gè)。
0x95, 0x06, // REPORT_COUNT (6)
//這是一個(gè)全局條目。定義每個(gè)位域長(zhǎng)度為8bit。
//其實(shí)這里這個(gè)條目不要也是可以的,因?yàn)樵谇懊嬉呀?jīng)有一個(gè)定義
//長(zhǎng)度為8bit的全局條目了。
0x75, 0x08, // REPORT_SIZE (8)
//這是一個(gè)全局條目,定義邏輯最小值為0。
//同上,這里這個(gè)全局條目也是可以不要的,因?yàn)榍懊嬉呀?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的數(shù)據(jù)域是輸入用的,
//屬性為:Data,Ary,Abs。Data說(shuō)明數(shù)據(jù)是可以變的,Ary說(shuō)明
//這些數(shù)據(jù)域是一個(gè)數(shù)組,即每個(gè)8bit都可以表示某個(gè)鍵值,
//如果按下的鍵太多(例如超過(guò)這里定義的長(zhǎng)度或者鍵盤(pán)本身無(wú)法
//掃描出按鍵情況時(shí)),則這些數(shù)據(jù)返回全1(二進(jìn)制),表示按鍵無(wú)效。
//Abs表示這些值是絕對(duì)值。
0x81, 0x00, // INPUT (Data,Ary,Abs)
//以下為輸出報(bào)告的描述
//邏輯最小值前面已經(jīng)有定義為0了,這里可以省略。
//這是一個(gè)全局條目,說(shuō)明邏輯值最大為1。
0x25, 0x01, // LOGICAL_MAXIMUM (1)
//這是一個(gè)全局條目,說(shuō)明數(shù)據(jù)域數(shù)量為5個(gè)。
0x95, 0x05, // REPORT_COUNT (5)
//這是一個(gè)全局條目,說(shuō)明數(shù)據(jù)域的長(zhǎng)度為1bit。
0x75, 0x01, // REPORT_SIZE (1)
//這是一個(gè)全局條目,說(shuō)明使用的用途頁(yè)為指示燈(LED)
0x05, 0x08, // USAGE_PAGE (LEDs)
//這是一個(gè)局部條目,說(shuō)明用途最小值為數(shù)字鍵盤(pán)燈。
0x19, 0x01, // USAGE_MINIMUM (Num Lock)
//這是一個(gè)局部條目,說(shuō)明用途最大值為Kana燈。
0x29, 0x05, // USAGE_MAXIMUM (Kana)
//這是一個(gè)主條目。定義輸出數(shù)據(jù),即前面定義的5個(gè)LED。
0x91, 0x02, // OUTPUT (Data,Var,Abs)
//這是一個(gè)全局條目。定義位域數(shù)量為1個(gè)。
0x95, 0x01, // REPORT_COUNT (1)
//這是一個(gè)全局條目。定義位域長(zhǎng)度為3bit。
0x75, 0x03, // REPORT_SIZE (3)
//這是一個(gè)主條目,定義輸出常量,前面用了5bit,所以這里需要
//3個(gè)bit來(lái)湊成一字節(jié)。
0x91, 0x03, // OUTPUT (Cnst,Var,Abs)
//下面這個(gè)主條目用來(lái)關(guān)閉前面的集合。bSize為0,所以后面沒(méi)數(shù)據(jù)。
0xc0, // END_COLLECTION
//以下注釋不包括第一字節(jié)報(bào)告ID。
//通過(guò)上面的報(bào)告描述符的定義,我們知道返回的輸入報(bào)告具有8字節(jié)。
//第一字節(jié)的8個(gè)bit用來(lái)表示特殊鍵是否按下(例如Shift、Alt等鍵)。
//第二字節(jié)為保留值,值為常量0。第三到第八字節(jié)是一個(gè)普通鍵鍵值的
//數(shù)組,當(dāng)沒(méi)有鍵按下時(shí),全部6個(gè)字節(jié)值都為0。當(dāng)只有一個(gè)普通鍵按下時(shí),
//這六個(gè)字節(jié)中的第一字節(jié)值即為該按鍵的鍵值(具體的鍵值請(qǐng)看HID的
//用途表文檔),當(dāng)有多個(gè)普通鍵同時(shí)按下時(shí),則同時(shí)返回這些鍵的鍵值。
//如果按下的鍵太多,則這六個(gè)字節(jié)都為0xFF(不能返回0x00,這樣會(huì)讓
//操作系統(tǒng)認(rèn)為所有鍵都已經(jīng)釋放)。至于鍵值在數(shù)組中的先后順序是
//無(wú)所謂的,操作系統(tǒng)會(huì)負(fù)責(zé)檢查是否有新鍵按下。我們應(yīng)該在中斷端點(diǎn)1
//中按照上面的格式返回實(shí)際的鍵盤(pán)數(shù)據(jù)。另外,報(bào)告中還定義了一個(gè)字節(jié)
//的輸出報(bào)告,是用來(lái)控制LED情況的。只使用了低7位,高1位是保留值0。
//當(dāng)某位的值為1時(shí),則表示對(duì)應(yīng)的LED要點(diǎn)亮。操作系統(tǒng)會(huì)負(fù)責(zé)同步各個(gè)
//鍵盤(pán)之間的LED,例如你有兩塊鍵盤(pán),一塊的數(shù)字鍵盤(pán)燈亮?xí)r,另一塊
//也會(huì)跟著亮。鍵盤(pán)本身不需要判斷各種LED應(yīng)該何時(shí)亮,它只是等待主機(jī)
//發(fā)送報(bào)告給它,然后根據(jù)報(bào)告值來(lái)點(diǎn)亮相應(yīng)的LED。我們?cè)诙它c(diǎn)1輸出中斷
//中讀出這1字節(jié)的輸出報(bào)告,然后對(duì)它取反(因?yàn)閷W(xué)習(xí)板上的LED是低電平時(shí)
//亮),直接發(fā)送到LED上。這樣main函數(shù)中按鍵點(diǎn)亮LED的代碼就不需要了。
/************************USB鼠標(biāo)部分報(bào)告描述符**********************/
/*******************************************************************/
//這是一個(gè)全局(bType為1)條目,選擇用途頁(yè)為普通桌面Generic Desktop Page(0x01)
0x05, 0x01, // USAGE_PAGE (Generic Desktop)
//這是一個(gè)局部(bType為2)條目,說(shuō)明接下來(lái)的應(yīng)用集合用途用于鼠標(biāo)
0x09, 0x02, // USAGE (Mouse)
//這是一個(gè)主條目(bType為0)條目,開(kāi)集合,后面跟的數(shù)據(jù)0x01表示
//該集合是一個(gè)應(yīng)用集合。它的性質(zhì)在前面由用途頁(yè)和用途定義為
//普通桌面用的鼠標(biāo)。
0xa1, 0x01, // COLLECTION (Application)
//報(bào)告ID,這里定義鼠標(biāo)報(bào)告的ID為2
0x85, 0x02, //Report ID (2)
//這是一個(gè)局部條目。說(shuō)明用途為指針集合
0x09, 0x01, // USAGE (Pointer)
//這是一個(gè)主條目,開(kāi)集合,后面跟的數(shù)據(jù)0x00表示該集合是一個(gè)
//物理集合,用途由前面的局部條目定義為指針集合。
0xa1, 0x00, // COLLECTION (Physical)
//這是一個(gè)全局條目,選擇用途頁(yè)為按鍵(Button Page(0x09))
0x05, 0x09, // USAGE_PAGE (Button)
//這是一個(gè)局部條目,說(shuō)明用途的最小值為1。實(shí)際上是鼠標(biāo)左鍵。
0x19, 0x01, // USAGE_MINIMUM (Button 1)
//這是一個(gè)局部條目,說(shuō)明用途的最大值為3。實(shí)際上是鼠標(biāo)中鍵。
0x29, 0x03, // USAGE_MAXIMUM (Button 3)
//這是一個(gè)全局條目,說(shuō)明返回的數(shù)據(jù)的邏輯值(就是我們返回的數(shù)據(jù)域的值啦)
//最小為0。因?yàn)槲覀冞@里用Bit來(lái)表示一個(gè)數(shù)據(jù)域,因此最小為0,最大為1。
0x15, 0x00, // LOGICAL_MINIMUM (0)
//這是一個(gè)全局條目,說(shuō)明邏輯值最大為1。
0x25, 0x01, // LOGICAL_MAXIMUM (1)
//這是一個(gè)全局條目,說(shuō)明數(shù)據(jù)域的數(shù)量為三個(gè)。
0x95, 0x03, // REPORT_COUNT (3)
//這是一個(gè)全局條目,說(shuō)明每個(gè)數(shù)據(jù)域的長(zhǎng)度為1個(gè)bit。
0x75, 0x01, // REPORT_SIZE (1)
//這是一個(gè)主條目,說(shuō)明有3個(gè)長(zhǎng)度為1bit的數(shù)據(jù)域(數(shù)量和長(zhǎng)度
//由前面的兩個(gè)全局條目所定義)用來(lái)做為輸入,
//屬性為:Data,Var,Abs。Data表示這些數(shù)據(jù)可以變動(dòng),Var表示
//這些數(shù)據(jù)域是獨(dú)立的,每個(gè)域表示一個(gè)意思。Abs表示絕對(duì)值。
//這樣定義的結(jié)果就是,第一個(gè)數(shù)據(jù)域bit0表示按鍵1(左鍵)是否按下,
//第二個(gè)數(shù)據(jù)域bit1表示按鍵2(右鍵)是否按下,第三個(gè)數(shù)據(jù)域bit2表示
//按鍵3(中鍵)是否按下。
0x81, 0x02, // INPUT (Data,Var,Abs)
//這是一個(gè)全局條目,說(shuō)明數(shù)據(jù)域數(shù)量為1個(gè)
0x95, 0x01, // REPORT_COUNT (1)
//這是一個(gè)全局條目,說(shuō)明每個(gè)數(shù)據(jù)域的長(zhǎng)度為5bit。
0x75, 0x05, // REPORT_SIZE (5)
//這是一個(gè)主條目,輸入用,由前面兩個(gè)全局條目可知,長(zhǎng)度為5bit,
//數(shù)量為1個(gè)。它的屬性為常量(即返回的數(shù)據(jù)一直是0)。
//這個(gè)只是為了湊齊一個(gè)字節(jié)(前面用了3個(gè)bit)而填充的一些數(shù)據(jù)
//而已,所以它是沒(méi)有實(shí)際用途的。
0x81, 0x03, // INPUT (Cnst,Var,Abs)
//這是一個(gè)全局條目,選擇用途頁(yè)為普通桌面Generic Desktop Page(0x01)
0x05, 0x01, // USAGE_PAGE (Generic Desktop)
//這是一個(gè)局部條目,說(shuō)明用途為X軸
0x09, 0x30, // USAGE (X)
//這是一個(gè)局部條目,說(shuō)明用途為Y軸
0x09, 0x31, // USAGE (Y)
//這是一個(gè)局部條目,說(shuō)明用途為滾輪
0x09, 0x38, // USAGE (Wheel)
//下面兩個(gè)為全局條目,說(shuō)明返回的邏輯最小和最大值。
//因?yàn)槭髽?biāo)指針移動(dòng)時(shí),通常是用相對(duì)值來(lái)表示的,
//相對(duì)值的意思就是,當(dāng)指針移動(dòng)時(shí),只發(fā)送移動(dòng)量。
//往右移動(dòng)時(shí),X值為正;往下移動(dòng)時(shí),Y值為正。
//對(duì)于滾輪,當(dāng)滾輪往上滾時(shí),值為正。
0x15, 0x81, // LOGICAL_MINIMUM (-127)
0x25, 0x7f, // LOGICAL_MAXIMUM (127)
//這是一個(gè)全局條目,說(shuō)明數(shù)據(jù)域的長(zhǎng)度為8bit。
0x75, 0x08, // REPORT_SIZE (8)
//這是一個(gè)全局條目,說(shuō)明數(shù)據(jù)域的個(gè)數(shù)為3個(gè)。
0x95, 0x03, // REPORT_COUNT (3)
//這是一個(gè)主條目。它說(shuō)明這三個(gè)8bit的數(shù)據(jù)域是輸入用的,
//屬性為:Data,Var,Rel。Data說(shuō)明數(shù)據(jù)是可以變的,Var說(shuō)明
//這些數(shù)據(jù)域是獨(dú)立的,即第一個(gè)8bit表示X軸,第二個(gè)8bit表示
//Y軸,第三個(gè)8bit表示滾輪。Rel表示這些值是相對(duì)值。
0x81, 0x06, // INPUT (Data,Var,Rel)
//下面這兩個(gè)主條目用來(lái)關(guān)閉前面的集合用。
//我們開(kāi)了兩個(gè)集合,所以要關(guān)兩次。bSize為0,所以后面沒(méi)數(shù)據(jù)。
0xc0, // END_COLLECTION
0xc0 // END_COLLECTION
//以下注釋不包括第一字節(jié)報(bào)告ID。
//通過(guò)上面的報(bào)告描述符的定義,我們知道返回的輸入報(bào)告具有4字節(jié)。
//第一字節(jié)的低3位用來(lái)表示按鍵是否按下的,高5位為常數(shù)0,無(wú)用。
//第二字節(jié)表示X軸改的變量,第三字節(jié)表示Y軸的改變量,第四字節(jié)表示
//滾輪的改變量。我們?cè)谥袛喽它c(diǎn)1中應(yīng)該要按照上面的格式返回實(shí)際的
//鼠標(biāo)數(shù)據(jù)。
};
// USB String Descriptors
const u8 HID_StringLangID[HID_SIZE_STRING_LANGID]=
{
HID_SIZE_STRING_LANGID,
USB_STRING_DESCRIPTOR_TYPE,
0x09,
0x04
};
const u8 HID_StringVendor[HID_SIZE_STRING_VENDOR]=
{
HID_SIZE_STRING_VENDOR,
USB_STRING_DESCRIPTOR_TYPE,
'S', 0, 'T', 0, 'M', 0, 'i', 0, 'c', 0, 'r', 0, 'o', 0, 'e', 0,
'l', 0, 'e', 0, 'c', 0, 't', 0, 'r', 0, 'o', 0, 'n', 0, 'i', 0,
'c', 0, 's', 0
};
const u8 HID_StringProduct[HID_SIZE_STRING_PRODUCT] =
{
HID_SIZE_STRING_PRODUCT, /* bLength */
USB_STRING_DESCRIPTOR_TYPE, /* bDescriptorType */
0x34, 0x6c, //水
0x62, 0x97, //面
0x4b, 0x4e, //之
0x0b, 0x4e, //下
0x84, 0x76, //的
0x55, 0x00, //U
0x53, 0x00, //S
0x42, 0x00, //B
0x4b, 0x6d, //測(cè)
0xd5, 0x8b, //試
};
u8 HID_StringSerial[HID_SIZE_STRING_SERIAL] =
{
HID_SIZE_STRING_SERIAL, /* bLength */
USB_STRING_DESCRIPTOR_TYPE, /* bDescriptorType */
0x73, 0x00, //s
0x6e, 0x00, //n
0x69, 0x00, //i
0x63, 0x00, //c
0x5f, 0x00, //_
0x6b, 0x00, //k
0x84, 0x76, //的
0x55, 0x00, //U
0x53, 0x00, //S
0x42, 0x00, //B
0x2e, 0x95, //鍵
0xd8, 0x76, //盤(pán)
};
評(píng)論
查看更多