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