開發板文檔資料里提供了演示程序,當然對于PID,VID和字符串描述符不做修改也可以用于我們的程序,但是要想實現我們自己的通信協議,就必須修改報告描述符,它規定了通信數據包的含義、最大字節數等。演示程序中的報告描述符,描述了7個ID,分別是LED1-4,2個按鍵和1個A/D,所以描述符很長,在改程序中,我們采用了《圈圈教你玩USB》里的報告描述符,僅僅描述了一個ID-7。描述符定義如下。
constuint8_tCustomHID_ReportDescriptor[CUSTOMHID_SIZ_REPORT_DESC]=
{
//每行開始的第一字節為該條目的前綴,前綴的格式為:
//D7~D4:bTag。D3~D2:bType;D1~D0:bSize。以下分別對每個條目注釋。
//這是一個全局(bType為1)條目,將用途頁選擇為普通桌面GenericDesktopPage。
//后面跟1字節數據(bSize為1),后面的字節數就不注釋了,自己根據bSize來判斷。
0x05,0x01,//USAGE_PAGE(GenericDesktop)
//這是一個局部(bType為2)條目,用途選擇為0x00。在普通桌面頁中,
//該用途是未定義的,如果使用該用途來開集合,那么系統將不會把它
//當作標準系統設備,從而就成了一個用戶自定義的HID設備。
0x09,0x00,//USAGE(0)
//這是一個主條目(bType為0)條目,開集合,后面跟的數據0x01表示
//該集合是一個應用集合。它的性質在前面由用途頁和用途定義為
//用戶自定義。
0xa1,0x01,//COLLECTION(Application)
0x85,0x07,/*REPORT_ID(7)*/
0x09,0x07,/*USAGE*/
//這是一個全局條目,說明邏輯值最小值為0。
0x15,0x00,//LOGICAL_MINIMUM(0)
//這是一個全局條目,說明邏輯值最大為255。
0x25,0xff,//LOGICAL_MAXIMUM(255)
//這是一個局部條目,說明用途的最小值為1。
0x19,0x01,//USAGE_MINIMUM(1)
//這是一個局部條目,說明用途的最大值8。
0x29,0x08,//USAGE_MAXIMUM(8)
//這是一個全局條目,說明數據域的數量為八個。
0x95,0x08,//REPORT_COUNT(8)
//這是一個全局條目,說明每個數據域的長度為8bit,即1字節。
0x75,0x08,//REPORT_SIZE(8)
//這是一個主條目,說明有8個長度為8bit的數據域做為輸入。
0x81,0x02,//INPUT(Data,Var,Abs)
//這是一個局部條目,說明用途的最小值為1。
0x19,0x01,//USAGE_MINIMUM(1)
//這是一個局部條目,說明用途的最大值8。
0x29,0x08,//USAGE_MAXIMUM(8)
0x85,0x07,/*REPORT_ID(7)*/
0x09,0x07,/*USAGE*/
//這是一個主條目。定義輸出數據(8字節,注意前面的全局條目)。
0x91,0x02,//OUTPUT(Data,Var,Abs)
//下面這個主條目用來關閉前面的集合。bSize為0,所以后面沒數據。
0xc0//END_COLLECTION
};/*CustomHID_ReportDescriptor*/
我們把
0x85,0x07,/*REPORT_ID(7)*/
0x09,0x07,/*USAGE*/
單獨拿出來講述,從上面的描述符可以看出,有兩個這樣的模塊,前一個定義為輸入(Device-Host)報告ID,后一個定義為輸出(Host-Device)報告ID。這兩個模塊很有用,如果沒有這兩個ID,則數據是發生不出去的。
如果不定義輸入報告,STM32F107的數據就發送不出來,定義了輸入報告,但是沒有定義輸出報告,STM32F107的數據可以發送出來,可以通過USBTrace觀察到,但是與之對應的Host收不到數據。只有兩者都定義了,才可以正常收發數據。
《圈圈教你玩USB》書中,沒有這么說明,我不知道為什么,直接使用他的報告描述符,下位機的數據是發送不出來的。
還有一個問題,就是我定義了ID7,但是我發送數據的第一個字節不是7而是6,同樣,STM32F107的數據可以發送出來,可以通過USBTrace觀察到,但是與之對應的Host收不到數據。與下位機不同,如果在報告描述中定義了ID為7的輸入輸出報告,但是上位機發送數據的首字節不是7而是6,則數據根本發不出來。
評論
查看更多