开发板文档资料里提供了演示程序,当然对于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,则数据根本发不出来。
评论
查看更多