相關文章

下面編寫下USB鍵盤的程式，依然在CustomHID工程上修改。

依舊最先修改的是usb_desc.c檔案。我們從裝置描述符開始講述。

裝置描述符需要修改下bMaxPacketSize(最大包長度)域為0x08，因為被本次的工程最大通訊長度就是8位元組，正好符合USB規範，所以這裡改成0x08，還要注意在usb_prop.c的DEVICE_PROP Device_Property結構體裡註冊的最大長度也要是0x08，與裝置描述符的要相同(我們在下文說到)。這裡最好還要修改下PID和VID的域的值，以防該PID和VID對應的裝置已經在電腦裡有了驅動而導致功能不正常。

/* USB

標準裝置描述符*/

const uint8_t Keyboard_DeviceDescriptor[KEYBOARD_SIZ_DEVICE_DESC] =

{

    0x12,                     /*bLength：長度，裝置描述符的長度為18位元組*/

    USB_DEVICE_DESCRIPTOR_TYPE, /*bDescriptorType：型別，裝置描述符的編號是0x01*/

    0x00,                       /*bcdUSB：所使用的USB版本為2.0*/

    0x02,

    0x00,                       /*bDeviceClass

：裝置所使用的類程式碼*/

    0x00,                       /*bDeviceSubClass：裝置所使用的子類程式碼*/

    0x00,                       /*bDeviceProtocol：裝置所使用的協議*/

    0x08,                       /*bMaxPacketSize：最大包長度為8位元組*/

    0x78,                       /*idVendor：廠商ID為0x7788*/

    0x67,

    0x12,                            /*idProduct

：產品ID為0x1122*/

    0x01,

    0x00,                       /*bcdDevice：裝置的版本號為2.00*/

    0x02,

    1,                          /*iManufacturer:廠商字串的索引*/

    2,                          /*iProduct：產品字串的索引*/

    3,                          /*iSerialNumber：裝置的序列號字串索引*/

    0x01                        /*bNumConfiguration：裝置有1種配置*/

}; /* keyboard裝置描述符 */

接下去修改下配置描述符。找到介面的描述符的bNumEndpoints(該介面所使用的端點數)域，不用修改,但需要提下，還是0x02，表示使用2個端點。修改下介面描述符的nInterfaceProtocol (該介面使用的協議)域為0x01，表示是鍵盤。在輸入端點描述符中端點設定端點1為為中斷傳輸的輸入端點，設定 wMaxPacketSize:(該端點支援的最大包長度)域的值為0x08，因為本次鍵盤的工程需要向USB主機發送8位元組。在輸出端點描述符設定端點1為中斷傳輸的輸出端點，設定為中斷傳輸設定 wMaxPacketSize:(該端點支援的最大包長度)域的值為0x01，因為USB主機只會向USB從裝置傳送1個位元組。

/* USB配置描述符集合(配置、介面、端點、類、廠商)(Configuration, Interface, Endpoint, Class, Vendor */

const uint8_t Keyboard_ConfigDescriptor[KEYBOARD_SIZ_CONFIG_DESC] =

{

    0x09,                   /*bLength：長度，裝置字串的長度為9位元組*/

    USB_CONFIGURATION_DESCRIPTOR_TYPE,    /*bDescriptorType：型別，配置描述符的型別編號為0x2*/

    KEYBOARD_SIZ_CONFIG_DESC,                    /*wTotalLength：配置描述符的總長度為41位元組*/   

    0x00,

    0x01,             /*bNumInterfaces：配置所支援的介面數量1個*/

    0x01,             /*bConfigurationValue：該配置的值*/

    0x00,             /*iConfiguration：該配置的字串的索引值，該值為0表示沒有字串*/             

    0xC0,             /* bmAttributes:裝置的一些特性，0xc0表示自供電，不支援遠端喚醒

                                          D7:保留必須為1，D6:是否自供電，D5：是否支援遠端喚醒，D4~D0：保留設定為0*/

    0x32,             /*從總線上獲得的最大電流為100mA */

//    0x96,         /*MaxPower：裝置需要從總線上獲取多少電流，單位為2mA，0x96表示300mA*/

    /************** 介面描述符****************/

       /* 09 */

    0x09,             /*bLength：長度，介面描述符的長度為9位元組 */

    USB_INTERFACE_DESCRIPTOR_TYPE,/* bDescriptorType：介面描述符的型別為0x4 */

    0x00,             /*bInterfaceNumber：該介面的編號*/

    0x00,             /*bAlternateSetting：該介面的備用編號 */

    0x02,             /*bNumEndpoints：該介面所使用的端點數*/

    0x03,             /*bInterfaceClass該介面所使用的類為HID*/

    0x01,             /*bInterfaceSubClass：該介面所用的子類 1=BOOT, 0=no boot */

    0x01,             /*nInterfaceProtocol :該介面使用的協議0=none, 1=keyboard, 2=mouse */

    0,                /*iInterface: 該介面字串的索引 */

    /*****************HID描述符 ********************/

       /* 18 */

    0x09,             /*bLength: HID描述符的長度為9位元組 */

    HID_DESCRIPTOR_TYPE, /* bDescriptorType: HID的描述符型別為0x21 */

    0x10,             /*bcdHID: HID協議的版本為1.1 */

    0x01,

    0x21,             /*bCountryCode: 國家代號 */

    0x01,             /*bNumDescriptors: 下級描述符的數量*/

    0x22,             /*bDescriptorType：下級描述符的型別*/

    KEYBOARD_SIZ_REPORT_DESC,/* wItemLength: 下一集描述符的長度*/

    0x00,

    /********************輸入端點描述符******************/

       /* 27 */

    0x07,             /* bLength: 端點描述符的長度為7位元組*/

    USB_ENDPOINT_DESCRIPTOR_TYPE, /* bDescriptorType: 端點描述符的型別為0x05*/

    0x81,             /* bEndpointAddress: 該端點(輸入)的地址,D7:0(OUT),1(IN),D6~D4:保留,D3~D0:端點號*/              

    0x03,             /* bmAttributes: 端點的屬性為為中斷端點.

                     D0~D1表示傳輸型別:0(控制傳輸),1(等時傳輸),2(批量傳輸),3(中斷傳輸)

                     非等時傳輸端點:D2~D7:保留為0

                     等時傳輸端點：

                     D2~D3表示同步的型別:0(無同步),1(非同步),2(適配),3(同步)

                     D4~D5表示用途:0(資料端點),1(反饋端點),2(暗含反饋的資料端點),3(保留)，D6~D7:保留,*/

    0x08,             /* wMaxPacketSize: 該端點支援的最大包長度為8位元組*/

    0x00,

    0x0A,             /* bInterval: 輪詢間隔(32ms) */

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

       /* 34 */

       0x07,         /* bLength: 端點描述符的長度為7位元組*/

    USB_ENDPOINT_DESCRIPTOR_TYPE, /* bDescriptorType: 端點描述符的型別為0x05*/

    0x01,             /* bEndpointAddress: 該端點(輸入)的地址,D7:0(OUT),1(IN),D6~D4:保留,D3~D0:端點號*/              

    0x03,             /* bmAttributes: 端點的屬性為為中斷端點.

                     D0~D1表示傳輸型別:0(控制傳輸),1(等時傳輸),2(批量傳輸),3(中斷傳輸)

                     非等時傳輸端點:D2~D7:保留為0

                     等時傳輸端點：

                     D2~D3表示同步的型別:0(無同步),1(非同步),2(適配),3(同步)

                     D4~D5表示用途:0(資料端點),1(反饋端點),2(暗含反饋的資料端點),3(保留)，D6~D7:保留,*/

    0x01,             /* wMaxPacketSize: 該端點支援的最大包長度為位元組*/

    0x00,

    0x0A,             /* bInterval: 輪詢間隔(32ms) */

   /* 41 */

};

講到報告描述符，得將報告描述符的整個替換掉。該報告描述符定義了8位元組的輸入域，第一個位元組表示特殊件是否按下，鍵盤的特殊鍵包括:ctrl,shift,alt鍵等，該位元組D0表示Ctrl鍵，D1表示Shift鍵，D2表示Alt鍵，其他位保留。第二個位元組保留，固定值為0。第三個位元組到第八個位元組用來儲存按鍵值，如果只有一個按鍵按下，則按鍵值儲存在第三個位元組，如果有兩個或兩個以上的按鍵按下，則依次儲存在從第三位元組開始的位元組中，當然最多隻能6個按鍵同時按下，超過6個鍵值，則不響應。報告描述符還定義了一個位元組的輸出域，該位元組是是用來控制LED燈的，我們都知道鍵盤的上有幾個LED燈，比如說大小寫鍵的LED燈等，該位元組的定義:D0:Num Lock   D1:Cap Lock   D2:Scroll Lock   D3:Compose   D4:Kana，由於我一直用膝上型電腦的鍵盤，所以我也只認識前三個鍵。在這個工程，我只做了Ctrl鍵、Shift鍵、Num Lock鍵，以及A鍵。

/* HID的報告描述符*/

/*定義了8位元組傳送：

**  第一位元組表示特殊件是否按下：D0:Ctrl D1:Shift D2:Alt

**  第二位元組保留，值為0

**  第三~第八位元組:普通鍵鍵值的陣列,最多能同時按下6個鍵

**定義了1位元組接收:對應鍵盤上的LED燈,這裡只用了兩個位。

**     D0:Num Lock   D1:Cap Lock   D2:Scroll Lock   D3:Compose   D4:Kana*/

const uint8_t Keyboard_ReportDescriptor[KEYBOARD_SIZ_REPORT_DESC] =

{     

       /*short Item   D7~D4:bTag;D3~D2:bType;D1~D0:bSize

       **bTag ---主條目      1000:輸入(Input) 1001:輸出(Output) 1011:特性(Feature) 1010:集合(Collection) 1100:關集合(End Collection)

       **              全域性條目     0000:用途頁(Usage Page) 0001:邏輯最小值(Logical Minimum) 0010:邏輯最大值(Logical Maximum) 0011:物理最小值(Physical Minimum)

       **                                 0100:物理最大值(Physical Maximum) 0101:單元指數(Unit Exponet) 0110:單元(Unit) 0111:資料域大小(Report Size)

       **                                 1000:報告ID(Report ID) 1001:資料域數量(Report Count) 1010:壓棧(Push) 1011:出棧(Pop) 1100~1111:保留(Reserved)

       **              區域性條目     0000:用途(Usage) 0001:用途最小值(Usage Minimum) 0010:用途最大值(Usage Maximum) 0011:識別符號索引(Designator Index)

       **                                 0100:識別符號最小值(Designator Minimum) 0101:識別符號最大值(Designator Maximum) 0111:字串索引(String Index) 1000:字串最小值(String Minimum)  

       **                                 1001:字串最大值(String Maximum) 1010:分隔符(Delimiter) 其他：保留(Reserved)

       **bType---00:主條目(main)  01:全域性條目(globle)  10:區域性條目(local)  11:保留(reserved)

       **bSize---00:0位元組  01:1位元組  10:2位元組  11:4位元組*/

       //0x05:0000 01 01 這是個全域性條目，用途頁選擇為普通桌面頁

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

       //0x09:0000 10 01 這是個全域性條目，用途選擇為鍵盤

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

       //0xa1:1010 00 01 這是個主條目，選擇為應用集合，

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

       //0x05:0000 01 11 這是個全域性條目，用途頁選擇為鍵盤/按鍵

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

       //0x19:0001 10 01 這是個區域性條目，用途的最小值為0xe0，對應鍵盤上的左ctrl鍵

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

       //0x29:0010 10 01 這是個區域性條目，用途的最大值為0xe7，對應鍵盤上的有GUI(WIN)鍵

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

       //0x15:0001 01 01 這是個全域性條目，說明資料的邏輯值最小值為0

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

       //0x25:0010 01 01 這是個全域性條目，說明資料的邏輯值最大值為1

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

       //0x95:1001 01 01 這是個全域性條目，資料域的數量為8個

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

       //0x75:0111 01 01 這是個全域性條目，每個資料域的長度為1位

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

       //0x81:1000 00 01 這是個主條目，有8*1bit資料域作為輸入，屬性為:Data,Var,Abs

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

       //0x95:1001 01 01 這是個全域性條目,資料域的數量為1個

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

       //0x75:0111 01 01 這是個全域性條目，每個資料域的長度為8位

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

       //0x81:1000 00 01 這是個主條目，有1*8bit資料域作為輸入，屬性為:Cnst,Var,Abs

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

       //0x95:1001 01 01 這是個全域性條目，資料域的數量為6個

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

       //0x75:0111 01 01 這是個全域性條目，每個資料域的長度為8位

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

       //0x25:0010 01 01 這是個全域性條目，邏輯最大值為255

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

       //0x19:0001 10 01 這是個區域性條目，用途的最小值為0

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

       //0x29:0010 10 01 這是個區域性條目，用途的最大值為0x65

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

       //0x81:1000 00 01 這是個主條目，有6*8bit的資料域作為輸入，屬相為屬性為:Data,Var,Abs

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

       //0x25:0010 01 01 這是個全域性條目，邏輯的最大值為1

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

       //0x95:1001 01 01 這是個全域性條目，資料域的數量為2

       0x95, 0x02, // REPORT_COUNT (2)

       //0x75:0111 01 01 這是個全域性條目，每個資料域的長度為1位

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

       //0x05:0000 01 01 這是個全域性條目，用途頁選擇為LED頁

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

       //0x19:0001 10 01 這是個區域性條目，用途的最小值為0x01,對應鍵盤上的Num Lock

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

       //0x29:0010 10 01 這是個區域性條目，用途的最大值為0x02,對應鍵盤上的Caps Lock

       0x29, 0x02, // USAGE_MAXIMUM (Caps Lock)

       //0x91:1001 00 01 這是個主條目，有2*1bit的資料域作為輸出，屬性為:Data,Var,Abs

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

       //0x95:1001 01 01 這是個全域性條目，資料域的數量為1個

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

       //0x75:0111 01 01 這是個全域性條目，每個資料域的長度為6bit,正好與前面的2bit組成1位元組

       0x75, 0x06, // REPORT_SIZE (6)

       //0x91:1001 00 01 這是個主條目，有1*6bit資料域最為輸出，屬性為:Cnst,Var,Abs

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

       0xc0        // END_COLLECTION

};

說到按鍵的鍵值的定義，那就要參考HID用途表(從54頁開始)，截個開始的功能表吧，湊夠途中可以看到A鍵的鍵值是4。

其他的一些描述符，這裡也貼出來：

/* 語言ID描述符 */

const uint8_t Keyboard_StringLangID[KEYBOARD_SIZ_STRING_LANGID] =

{

    KEYBOARD_SIZ_STRING_LANGID,   /*bLength：本描述符的長度為4位元組*/

    USB_STRING_DESCRIPTOR_TYPE,           /*bDescriptorType：字串描述符的型別為0x03*/

    0x09,                                               /*bString：語言ID為0x0409，表示美式英語*/

    0x04

}; /* LangID = 0x0409: U.S. English*/

/*廠商字串描述符*/

const uint8_t Keyboard_StringVendor[KEYBOARD_SIZ_STRING_VENDOR] =

{

    KEYBOARD_SIZ_STRING_VENDOR,    /*bLength：廠商字串描述符的長度*/

    USB_STRING_DESCRIPTOR_TYPE,    /*bDescriptorType：字串描述符的型別為0x03*/

    'B' , 0, 'y', 0, ':' , 0, 'z' , 0, 'i', 0, 'y', 0,'e', 0,'3', 0, '3', 0, '4', 0  /*自定義*/

};

/*產品的字串描述符*/

const uint8_t Keyboard_StringProduct[KEYBOARD_SIZ_STRING_PRODUCT] =

{

    KEYBOARD_SIZ_STRING_PRODUCT,    /* bLength：產品的字串描述符*/

    USB_STRING_DESCRIPTOR_TYPE,     /* bDescriptorType：字串描述符的型別為0x03*/

    'z', 0, 'i', 0, 'y',

相關推薦