Arduino 控制USB设备（8） 鼠标的 Boot Protocol

zoologist

前面介绍了USB 鼠标数据的读取，个人感觉最困难的部分就是解析HID Descriptor，不同的鼠标的Descriptor不同，发出来的格式也不同。相比之下，键盘切换到 Boot Protocol 之后问题就简单多了。本文介绍如何将鼠标切换到这个模式下。
我们在之前中断方式获得鼠标改变代码的基础上，这样会使得整体效率比较高。
当 Mouse 工作在 Boot Protocol下面的时候，默认使用下面的 HID  Protocol【参考1】



根据资料，编写程序如下：

1. /* Mouse communication via interrupt endpoint  */
   
2. /* Assumes EP1 as interrupt IN ep              */
   
3. #include "max3421e.h"
   
4. #include "usb.h"
   
5. 
   
6. #define DEVADDR 1
   
7. #define CONFVALUE 1
   
8. #define EP_MAXPKTSIZE 5
   
9. EP_RECORD ep_record[ 2 ];  //endpoint record structure for the mouse
   
10. 
    
11. 
    
12. void setup();
    
13. void loop();
    
14. 
    
15. MAX3421E Max;
    
16. USB Usb;
    
17. 
    
18. void setup()
    
19. {
    
20.     Serial.begin( 115200 );
    
21.     Serial.println("Start");
    
22.     Max.powerOn();
    
23.     delay( 200 );
    
24. }
    
25. 
    
26. void loop()
    
27. {
    
28. byte rcode;
    
29.     Max.Task();
    
30.     Usb.Task();
    
31.     if( Usb.getUsbTaskState() == USB_STATE_CONFIGURING ) {
    
32.         mouse1_init();
    
33.     }//if( Usb.getUsbTaskState() == USB_STATE_CONFIGURING...
    
34.     if( Usb.getUsbTaskState() == USB_STATE_RUNNING ) {
    
35.         rcode = mouse1_poll();
    
36.         if( rcode ) {
    
37.           Serial.print("Mouse Poll Error: ");
    
38.           Serial.println( rcode, HEX );
    
39.         }//if( rcode...
    
40.     }//if( Usb.getUsbTaskState() == USB_STATE_RUNNING...
    
41. }
    
42. /* Initialize mouse */
    
43. void mouse1_init( void )
    
44. {
    
45. byte rcode = 0;  //return code
    
46. byte tmpdata;
    
47. byte* byte_ptr = &tmpdata;
    
48.   /**/
    
49.   ep_record[ 0 ] = *( Usb.getDevTableEntry( 0,0 ));  //copy endpoint 0 parameters
    
50.   ep_record[ 1 ].MaxPktSize = EP_MAXPKTSIZE;
    
51.   ep_record[ 1 ].sndToggle = bmSNDTOG0;
    
52.   ep_record[ 1 ].rcvToggle = bmRCVTOG0;
    
53.   Usb.setDevTableEntry( 1, ep_record );            
    
54.   /* Configure device */
    
55.   rcode = Usb.setConf( DEVADDR, 0, CONFVALUE );
    
56.   if( rcode ) {
    
57.     Serial.print("Error configuring mouse. Return code : ");
    
58.     Serial.println( rcode, HEX );
    
59.     while(1);  //stop
    
60.   }//if( rcode...
    
61.   
    
62.   rcode = Usb.setIdle( DEVADDR, 0, 0, 0, tmpdata );
    
63.   if( rcode ) {
    
64.     Serial.print("Set Idle error. Return code : ");
    
65.     Serial.println( rcode, HEX );
    
66.     while(1);  //stop
    
67.   }
    
68.   
    
69.   rcode = Usb.getIdle( DEVADDR, 0, 0, 0, (char *)byte_ptr );
    
70.   if( rcode ) {
    
71.     Serial.print("Get Idle error. Return code : ");
    
72.     Serial.println( rcode, HEX );
    
73.     while(1);  //stop
    
74.   }
    
75.   Serial.print("Idle Rate: ");
    
76.   Serial.print(( tmpdata * 4 ), DEC );        //rate is returned in multiples of 4ms
    
77.   Serial.println(" ms");
    
78.   tmpdata = 0;
    
79.   rcode = Usb.setIdle( DEVADDR, 0, 0, 0, tmpdata );
    
80.   if( rcode ) {
    
81.     Serial.print("Set Idle error. Return code : ");
    
82.     Serial.println( rcode, HEX );
    
83.     while(1);  //stop
    
84.   }
    
85.   
    
86.     /* Set boot protocol */
    
87.     rcode = Usb.setProto( DEVADDR, 0, 0, 0 );
    
88.     if( rcode ) {
    
89.          Serial.print("Error attempting to configure boot protocol. Return code :");
    
90.          Serial.println( rcode, HEX );
    
91.          while( 1 );  //stop
    
92.     }  
    
93.    
    
94.   Usb.setUsbTaskState( USB_STATE_RUNNING );
    
95.   return;
    
96. }
    
97. /* Poll mouse via interrupt endpoint and print result */
    
98. /* assumes EP1 as interrupt endpoint                  */
    
99. byte mouse1_poll( void )
    
100. {
     
101.   byte rcode,i;
     
102.   char buf[ 3 ] = { 0 };                          //mouse report buffer
     
103. 
     
104.   unsigned long int libuf[ sizeof(buf) ];
     
105.   unsigned long int x;
     
106.   unsigned long int y;
     
107. 
     
108.   
     
109.   /* poll mouse */
     
110.   rcode = Usb.inTransfer( DEVADDR, 1, sizeof(buf), buf, 1 );  //
     
111. 
     
112.     if( rcode ) {  //error
     
113.       if( rcode == 0x04 ) {  //NAK
     
114.         rcode = 0;
     
115.       }
     
116.       return( rcode );
     
117.     }
     
118.    
     
119.     for (int i=0;i<sizeof(buf);i++) {
     
120.        libuf[i]=(buf[i]) & 0xff;
     
121.        Serial.print(libuf[i],HEX); Serial.print("  ");
     
122.     }
     
123.    
     
124.     Serial.println("");
     
125.   
     
126.     return( rcode );
     
127. }

复制代码

运行结果：


特别注意：经过我的实验，不是所有的鼠标都支持 Boot Protocol ，前面实验中用到的Dell 和HP鼠标都无法正常工作，可能是这两种鼠标不支持Boot Protocol 。换一个角度说，如果客户使用 USB 键盘，那么一定要有进入 BIOS  Setup的需求，但是客户通常不会有在Setup中使用鼠标的需求，所以鼠标对于Boot Protocol的支持不好也在情理之中。
我发现好用的反倒是一个杂牌鼠标



完整代码

参考：

1.        HID Firmware Specification 1.11 P71

eysajan

支持！有了这个可以用普通电机也能做智能小车了吧？

msold5

正准备研究下这个东西

164335413

是不是可以支持其他的USB设备？USB的小键盘可以支持、鼠标也可以，其他的只要驱动不复杂，应该可以支持吧？

zoologist

164335413 发表于 2015-11-13 08:43
是不是可以支持其他的USB设备？USB的小键盘可以支持、鼠标也可以，其他的只要驱动不复杂，应该可以支持吧？

HID  设备数据格式都体现在HID 描述符中，所以没问题