STM32 JoystickMouse USB游戲桿鼠標(biāo)的實(shí)現(xiàn)
掃描二維碼
隨時(shí)隨地手機(jī)看文章
本次程序的實(shí)現(xiàn)是基于上次CustomHID修稿過(guò)來(lái)的,工程的架構(gòu)就不在介紹,這里主要介紹下,如何修改。
首先當(dāng)然是usb_desc.c的一些描述符了。
設(shè)備描述符需要修改下bMaxPacketSize(最大包長(zhǎng)度)為0x08個(gè)字節(jié),因?yàn)樵摴こ掏ㄓ嵉拈L(zhǎng)度為4字節(jié),根據(jù)USB洗衣規(guī)范,最大包長(zhǎng)度只能是8、16、64等,所以這里選擇0x08,這里要注意,改為0x08時(shí),在usb_prop.c的DEVICE_PROP Device_Property->MaxPacketSize域也要改成0x08(我們?cè)谙旅鏁?huì)說(shuō)到),要跟配置描述符定義的最大包長(zhǎng)度相同,否則,電腦上會(huì)出現(xiàn):“此設(shè)備未識(shí)別”類(lèi)似的提示。最好還要修改下廠(chǎng)商ID和產(chǎn)品ID兩項(xiàng)。因?yàn)椴恍薷腜ID和VID,如果你上次CustomHID或其他USB工程也使用同樣的PID和VID,這次的工程,電腦不會(huì)重新加載新的驅(qū)動(dòng),可能會(huì)使功能無(wú)法實(shí)現(xiàn)。如果出現(xiàn)上面的情況,只要打開(kāi)設(shè)備管理器,找到對(duì)應(yīng)的驅(qū)動(dòng)設(shè)備,然后右鍵選擇卸載,然后開(kāi)發(fā)板重新上電,電腦的右下方就會(huì)跳出:發(fā)現(xiàn)新硬件。還是貼出代碼吧:
/* USB標(biāo)準(zhǔn)設(shè)備描述符*/
const uint8_t Joystick_DeviceDescriptor[JOYSTICK_SIZ_DEVICE_DESC] =
{
0x12, /*bLength:長(zhǎng)度,設(shè)備描述符的長(zhǎng)度為18字節(jié)*/
USB_DEVICE_DESCRIPTOR_TYPE, /*bDescriptorType:類(lèi)型,設(shè)備描述符的編號(hào)是0x01*/
0x00, /*bcdUSB:所使用的USB版本為2.0*/
0x02,
0x00, /*bDeviceClass:設(shè)備所使用的類(lèi)代碼*/
0x00, /*bDeviceSubClass:設(shè)備所使用的子類(lèi)代碼*/
0x00, /*bDeviceProtocol:設(shè)備所使用的協(xié)議*/
0x08, /*bMaxPacketSize:最大包長(zhǎng)度為64字節(jié)*/
0x88, /*idVendor:廠(chǎng)商ID為0x7788*/
0x66,
0x22, /*idProduct:產(chǎn)品ID為0x1122*/
0x11,
0x00, /*bcdDevice:設(shè)備的版本號(hào)為2.00*/
0x02,
1, /*iManufacturer:廠(chǎng)商字符串的索引*/
2, /*iProduct:產(chǎn)品字符串的索引*/
3, /*iSerialNumber:設(shè)備的序列號(hào)字符串索引*/
0x01 /*bNumConfiguration:設(shè)備有1種配置*/
}; /* JoystickMouse設(shè)備描述符 */
接著需要修改配置描述符集。配置描述符可以不需要修改。找到接口的描述符的bNumEndpoints(該接口所使用的端點(diǎn)數(shù))域,修改為0x01,表示使用1個(gè)端點(diǎn),nInterfaceProtocol (該接口使用的協(xié)議)域,修改成0x02,表示使用mouse協(xié)議。HID描述符也不需要修改。輸入端點(diǎn)描述符跟CustomHID工程的一樣,可以修改下 wMaxPacketSize(該端點(diǎn)支持的最大包長(zhǎng)度)為0x04字節(jié),因?yàn)檫@里只用到四個(gè)字節(jié),注意這里的端點(diǎn)支持最大包長(zhǎng)度可以不用按照USB的只能是8、16、64等規(guī)范。接著刪掉CustomHID工程中的的輸出端點(diǎn)描述符。代碼如下:
/* USB配置描述符集合(配置、接口、端點(diǎn)、類(lèi)、廠(chǎng)商)(Configuration, Interface, Endpoint, Class, Vendor */
const uint8_t Joystick_ConfigDescriptor[JOYSTICK_SIZ_CONFIG_DESC] =
{
0x09, /*bLength:長(zhǎng)度,設(shè)備字符串的長(zhǎng)度為9字節(jié)*/
USB_CONFIGURATION_DESCRIPTOR_TYPE, /*bDescriptorType:類(lèi)型,配置描述符的類(lèi)型編號(hào)為0x2*/
JOYSTICK_SIZ_CONFIG_DESC, /*wTotalLength:配置描述符的總長(zhǎng)度為41字節(jié)*/
0x00,
0x01, /*bNumInterfaces:配置所支持的接口數(shù)量1個(gè)*/
0x01, /*bConfigurationValue:該配置的值*/
0x00, /*iConfiguration:該配置的字符串的索引值,該值為0表示沒(méi)有字符串*/
0xE0, /* bmAttributes:設(shè)備的一些特性,0xc0表示自供電,不支持遠(yuǎn)程喚醒
D7:保留必須為1,D6:是否自供電,D5:是否支持遠(yuǎn)程喚醒,D4~D0:保留設(shè)置為0*/
0x32, /*從總線(xiàn)上獲得的最大電流為100mA */
// 0x96, /*MaxPower:設(shè)備需要從總線(xiàn)上獲取多少電流,單位為2mA,0x96表示300mA*/
/************** 接口描述符****************/
/* 09 */
0x09, /*bLength:長(zhǎng)度,接口描述符的長(zhǎng)度為9字節(jié) */
USB_INTERFACE_DESCRIPTOR_TYPE,/* bDescriptorType:接口描述符的類(lèi)型為0x4 */
0x00, /*bInterfaceNumber:該接口的編號(hào)*/
0x00, /*bAlternateSetting:該接口的備用編號(hào) */
0x01, /*bNumEndpoints:該接口所使用的端點(diǎn)數(shù)*/
0x03, /*bInterfaceClass該接口所使用的類(lèi)為HID*/
0x01, /*bInterfaceSubClass:該接口所用的子類(lèi) 1=BOOT, 0=no boot */
0x02, /*nInterfaceProtocol :該接口使用的協(xié)議0=none, 1=keyboard, 2=mouse */
0, /*iInterface: 該接口字符串的索引 */
/*****************HID描述符 ********************/
/* 18 */
0x09, /*bLength: HID描述符的長(zhǎng)度為9字節(jié) */
HID_DESCRIPTOR_TYPE, /* bDescriptorType: HID的描述符類(lèi)型為0x21 */
0x10, /*bcdHID: HID協(xié)議的版本為1.1 */
0x01,
0x00, /*bCountryCode: 國(guó)家代號(hào) */
0x01, /*bNumDescriptors: 下級(jí)描述符的數(shù)量*/
0x22, /*bDescriptorType:下級(jí)描述符的類(lèi)型*/
JOYSTICK_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)描述符的類(lèi)型為0x21*/
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表示傳輸類(lèi)型:0(控制傳輸),1(等時(shí)傳輸),2(批量傳輸),3(中斷傳輸)
非等時(shí)傳輸端點(diǎn):D2~D7:保留為0
等時(shí)傳輸端點(diǎn):
D2~D3表示同步的類(lèi)型:0(無(wú)同步),1(異步),2(適配),3(同步)
D4~D5表示用途:0(數(shù)據(jù)端點(diǎn)),1(反饋端點(diǎn)),2(暗含反饋的數(shù)據(jù)端點(diǎn)),3(保留),D6~D7:保留,*/
0x04, /* wMaxPacketSize: 該端點(diǎn)支持的最大包長(zhǎng)度為4字節(jié)*/
0x00,
0x20, /* bInterval: 輪詢(xún)間隔(32ms) */
/* 34 */
};
還要替換下報(bào)告描述符,該描述符定義了四個(gè)字節(jié)的輸入數(shù)據(jù)域,第一個(gè)字節(jié)的D0位用來(lái)表示鼠標(biāo)的左鍵,D1為表示鼠標(biāo)的D2鍵,D3用來(lái)表示鼠標(biāo)的中鍵(有些鼠標(biāo)有的),其他5為保留,固定值為0。第二數(shù)據(jù)域表示鼠標(biāo)的X軸變化量,取值范圍為-127~127,正的表示向上移,符的表示向下移,這里需要注意的是,這個(gè)值表示鼠標(biāo)的變化量,而不是鼠標(biāo)的位置。第三個(gè)字節(jié)表示鼠標(biāo)的Y軸的變化量,取值范圍為-127~127,正值表示鼠標(biāo)往上移,負(fù)值表示鼠標(biāo)往下移,同樣注意這個(gè)值是表示鼠標(biāo)的變化量而不是鼠標(biāo)的位置。第四個(gè)值表示鼠標(biāo)的滾輪的變化量,取值范圍-127~127,正值表示向上滾,負(fù)值表示向下滾,同樣注意是變化量,而不是位置。代碼如下:
/* HID的報(bào)告描述符*/
const uint8_t Joystick_ReportDescriptor[JOYSTICK_SIZ_REPORT_DESC] =
{
/*short Item D7~D4:bTag;D3~D2:bType;D1~D0:bSize
**bTag ---主條目 1000:輸入(Input) 1001:輸出(Output) 1011:特性(Feature)1010:集合(Collection) 1100:關(guān)集合(End Collection)
** 全局條目 0000:用途頁(yè)(Usage Page) 0001:邏輯最小值(Logical Minimum) 0010:邏輯最大值(Logical Maximum) 0011:物理最小值(Physical Minimum)
**0100:物理最大值(Physical Maximum) 0101:單元指數(shù)(Unit Exponet) 0110:單元(Unit) 0111:數(shù)據(jù)域大小(Report Size)
**1000:報(bào)告ID(Report ID) 1001:數(shù)據(jù)域數(shù)量(Report Count) 1010:壓棧(Push) 1011:出棧(Pop) 1100~1111:保留(Reserved)
** 局部條目0000:用途(Usage) 0001:用途最小值(Usage Minimum) 0010:用途最大值(Usage Maximum) 0011:標(biāo)識(shí)符索引(Designator Index)
**0100: