1. //USB配置描述符集合的定义
2. //配置描述符总长度为9+9+9+7字节
3. code uint8 ConfigurationDescriptor[9+9+9+7]=
4. {
5. /***************配置描述符***********************/
6. //bLength字段。配置描述符的长度为9字节。
7. 0x09,
8. //bDescriptorType字段。配置描述符编号为0x02。
9. 0x02,
10. //wTotalLength字段。配置描述符集合的总长度，
11. //包括配置描述符本身、接口描述符、类描述符、端点描述符等。
12. sizeof(ConfigurationDescriptor)&0xFF, //低字节
13. (sizeof(ConfigurationDescriptor)>>8)&0xFF, //高字节
14. //bNumInterfaces字段。该配置包含的接口数，只有一个接口。
15. 0x01,
16. //bConfiguration字段。该配置的值为1。
17. 0x01,
18. //iConfigurationz字段，该配置的字符串索引。这里没有，为0。
19. 0x00,
20. //bmAttributes字段，该设备的属性。由于我们的板子是总线供电的，
21. //并且我们不想实现远程唤醒的功能，所以该字段的值为0x80。
22. 0x80,
23. //bMaxPower字段，该设备需要的最大电流量。由于我们的板子
24. //需要的电流不到100mA，因此我们这里设置为100mA。由于每单位
25. //电流为2mA，所以这里设置为50(0x32)。
26. 0x32,
27. /*******************接口描述符*********************/
28. //bLength字段。接口描述符的长度为9字节。
29. 0x09,
30. //bDescriptorType字段。接口描述符的编号为0x04。
31. 0x04,
32. //bInterfaceNumber字段。该接口的编号，第一个接口，编号为0。
33. 0x00,
34. //bAlternateSetting字段。该接口的备用编号，为0。
35. 0x00,
36. //bNumEndpoints字段。非0端点的数目。由于USB鼠标只需要一个
37. //中断输入端点，因此该值为1。
38. 0x01,
39. //bInterfaceClass字段。该接口所使用的类。USB鼠标是HID类，
40. //HID类的编码为0x03。
41. 0x03,
42. //bInterfaceSubClass字段。该接口所使用的子类。在HID1.1协议中，
43. //只规定了一种子类：支持BIOS引导启动的子类。
44. //USB键盘、鼠标属于该子类，子类代码为0x01。
45. 0x01,
46. //bInterfaceProtocol字段。如果子类为支持引导启动的子类，
47. //则协议可选择鼠标和键盘。键盘代码为0x01，鼠标代码为0x02。
48. 0x02,
49. //iConfiguration字段。该接口的字符串索引值。这里没有，为0。
50. 0x00,
51. /******************HID描述符************************/
52. //bLength字段。本HID描述符下只有一个下级描述符。所以长度为9字节。
53. 0x09,
54. //bDescriptorType字段。HID描述符的编号为0x21。
55. 0x21,
56. //bcdHID字段。本协议使用的HID1.1协议。注意低字节在先。
57. 0x10,
58. 0x01,
59. //bCountyCode字段。设备适用的国家代码，这里选择为美国，代码0x21。
60. 0x21,
61. //bNumDescriptors字段。下级描述符的数目。我们只有一个报告描述符。
62. 0x01,
63. //bDescritporType字段。下级描述符的类型，为报告描述符，编号为0x22。
64. 0x22,
65. //bDescriptorLength字段。下级描述符的长度。下级描述符为报告描述符。
66. sizeof(ReportDescriptor)&0xFF,
67. (sizeof(ReportDescriptor)>>8)&0xFF,
68. /**********************端点描述符***********************/
69. //bLength字段。端点描述符长度为7字节。
70. 0x07,
71. //bDescriptorType字段。端点描述符编号为0x05。
72. 0x05,
73. //bEndpointAddress字段。端点的地址。我们使用D12的输入端点1。
74. //D7位表示数据方向，输入端点D7为1。所以输入端点1的地址为0x81。
75. 0x81,
76. //bmAttributes字段。D1~D0为端点传输类型选择。
77. //该端点为中断端点。中断端点的编号为3。其它位保留为0。
78. 0x03,
79. //wMaxPacketSize字段。该端点的最大包长。端点1的最大包长为16字节。
80. //注意低字节在先。
81. 0x10,
82. 0x00,
83. //bInterval字段。端点查询的时间，我们设置为10个帧时间，即10ms。
84. 0x0A
85. };

1. //USB报告描述符
2. code uint8 ReportDescriport[]=
3. {
4. 0x00
5. };

1. case CONFIGURATION_DESCRIPTOR: //配置描述符
2. #ifdef DEBUG0
3. Prints("配置描述符。\r\n");
4. #endif
5. pSendData=ConfigurationDescriptor; //需要发送的数据为配置描述符
6. //判断请求的字节数是否比实际需要发送的字节数多
7. //这里请求的是配置描述符集合，因此数据长度就是
8. //ConfigurationDescriptor[3]*256+ConfigurationDescriptor[2]。
9. //如果请求的比实际的长，那么只返回实际长度的数据
10. SendLength=ConfigurationDescriptor[3];
11. SendLength=SendLength*256+ConfigurationDescriptor[2];
12. if(wLength>SendLength)
13. {
14. if(SendLength%DeviceDescriptor[7]==0) //并且刚好是整数个数据包时
15. {
16. NeedZeroPacket=1; //需要返回0长度的数据包
17. }
18. }
19. else
20. {
21. SendLength=wLength;
22. }
23. //将数据通过EP0返回
24. UsbEp0SendData();
25. break;

1. /************************语言ID的定义********************/
2. code uint8 LanguageId[4]=
3. {
4. 0x04, //本描述符的长度
5. 0x03, //字符串描述符
6. //0x0409为美式英语的ID
7. 0x09,
8. 0x04
9. };
10. //厂商字符串“电脑圈圈的USB专区 Http://group.ednchina.com/93/”的Unicode编码
11. //8位小端格式
12. code uint8 ManufacturerStringDescriptor[82]={
13. 82, //该描述符的长度为82字节
14. 0x03, //字符串描述符的类型编码为0x03
15. 0x35, 0x75, //电
16. 0x11, 0x81, //脑
17. 0x08, 0x57, //圈
18. 0x08, 0x57, //圈
19. 0x84, 0x76, //的
20. 0x55, 0x00, //U
21. 0x53, 0x00, //S
22. 0x42, 0x00, //B
23. 0x13, 0x4e, //专
24. 0x3a, 0x53, //区
25. 0x20, 0x00, //
26. 0x48, 0x00, //H
27. 0x74, 0x00, //t
28. 0x74, 0x00, //t
29. 0x70, 0x00, //p
30. 0x3a, 0x00, //:
31. 0x2f, 0x00, ///
32. 0x2f, 0x00, ///
33. 0x67, 0x00, //g
34. 0x72, 0x00, //r
35. 0x6f, 0x00, //o
36. 0x75, 0x00, //u
37. 0x70, 0x00, //p
38. 0x2e, 0x00, //.
39. 0x65, 0x00, //e
40. 0x64, 0x00, //d
41. 0x6e, 0x00, //n
42. 0x63, 0x00, //c
43. 0x68, 0x00, //h
44. 0x69, 0x00, //i
45. 0x6e, 0x00, //n
46. 0x61, 0x00, //a
47. 0x2e, 0x00, //.
48. 0x63, 0x00, //c
49. 0x6f, 0x00, //o
50. 0x6d, 0x00, //m
51. 0x2f, 0x00, ///
52. 0x39, 0x00, //9
53. 0x33, 0x00, //3
54. 0x2f, 0x00 ///
55. };
56. //字符串“《圈圈教你玩USB》之USB鼠标”的Unicode编码
57. //8位小端格式
58. code uint8 ProductStringDescriptor[34]={
59. 34, //该描述符的长度为34字节
60. 0x03, //字符串描述符的类型编码为0x03
61. 0x0a, 0x30, //《
62. 0x08, 0x57, //圈
63. 0x08, 0x57, //圈
64. 0x59, 0x65, //教
65. 0x60, 0x4f, //你
66. 0xa9, 0x73, //玩
67. 0x55, 0x00, //U
68. 0x53, 0x00, //S
69. 0x42, 0x00, //B
70. 0x0b, 0x30, //》
71. 0x4b, 0x4e, //之
72. 0x55, 0x00, //U
73. 0x53, 0x00, //S
74. 0x42, 0x00, //B
75. 0x20, 0x9f, //鼠
76. 0x07, 0x68 //标
77. };
78. //字符串“2008-07-07”的Unicode编码
79. //8位小端格式
80. code uint8 SerialNumberStringDescriptor[22]={
81. 22, //该描述符的长度为22字节
82. 0x03, //字符串描述符的类型编码为0x03
83. 0x32, 0x00, //2
84. 0x30, 0x00, //0
85. 0x30, 0x00, //0
86. 0x38, 0x00, //8
87. 0x2d, 0x00, //-
88. 0x30, 0x00, //0
89. 0x37, 0x00, //7
90. 0x2d, 0x00, //-
91. 0x30, 0x00, //0
92. 0x37, 0x00 //7
93. };

1. case SET_CONFIGURATION: //设置配置
2. #ifdef DEBUG0
3. Prints("设置配置。\r\n");
4. #endif
5. //使能非0端点。非0端点只有在设置为非0的配置后才能使能。
6. //wValue的低字节为配置的值，如果该值为非0，才能使能非0端点。
7. //保存当前配置值
8. ConfigValue=wValue&0xFF;
9. D12SetEndpointEnable(ConfigValue);
10. //返回一个0长度的状态数据包
11. SendLength=0;
12. NeedZeroPacket=1;
13. //将数据通过EP0返回
14. UsbEp0SendData();
15. break;

4）分析调试信息

1. case 1: //类请求
2. #ifdef DEBUG0
3. Prints("USB类输出请求：");
4. #endif
5. switch(bRequest)
6. {
7. case SET_IDLE:
8. #ifdef DEBUG0
9. Prints("设置空闲。\r\n");
10. #endif
11. //只需要返回一个0长度的数据包即可
12. SendLength=0;
13. NeedZeroPacket=1;
14. //将数据通过EP0返回
15. UsbEp0SendData();
16. break;
17. default:
18. #ifdef DEBUG0
19. Prints("未知请求。\r\n");
20. #endif
21. break;
22. }
23. break;

6）分析调试信息

1. //USB报告描述符的定义
2. code uint8 ReportDescriptor[]=
3. {
4. //每行开始的第一字节为该条目的前缀，前缀的格式为：
5. //D7~D4：bTag。D3~D2：bType；D1~D0：bSize。以下分别对每个条目注释。
6. //这是一个全局（bType为1）条目，选择用途页为普通桌面Generic Desktop Page(0x01)
7. //后面跟一字节数据（bSize为1），后面的字节数就不注释了，
8. //自己根据bSize来判断。
9. 0x05, 0x01, // USAGE_PAGE (Generic Desktop)
10. //这是一个局部（bType为2）条目，说明接下来的应用集合用途用于鼠标
11. 0x09, 0x02, // USAGE (Mouse)
12. //这是一个主条目（bType为0）条目，开集合，后面跟的数据0x01表示
13. //该集合是一个应用集合。它的性质在前面由用途页和用途定义为
14. //普通桌面用的鼠标。
15. 0xa1, 0x01, // COLLECTION (Application)
16. //这是一个局部条目。说明用途为指针集合
17. 0x09, 0x01, // USAGE (Pointer)
18. //这是一个主条目，开集合，后面跟的数据0x00表示该集合是一个
19. //物理集合，用途由前面的局部条目定义为指针集合。
20. 0xa1, 0x00, // COLLECTION (Physical)
21. //这是一个全局条目，选择用途页为按键（Button Page(0x09)）
22. 0x05, 0x09, // USAGE_PAGE (Button)
23. //这是一个局部条目，说明用途的最小值为1。实际上是鼠标左键。
24. 0x19, 0x01, // USAGE_MINIMUM (Button 1)
25. //这是一个局部条目，说明用途的最大值为3。实际上是鼠标中键。
26. 0x29, 0x03, // USAGE_MAXIMUM (Button 3)
27. //这是一个全局条目，说明返回的数据的逻辑值（就是我们返回的数据域的值啦）
28. //最小为0。因为我们这里用Bit来表示一个数据域，因此最小为0，最大为1。
29. 0x15, 0x00, // LOGICAL_MINIMUM (0)
30. //这是一个全局条目，说明逻辑值最大为1。
31. 0x25, 0x01, // LOGICAL_MAXIMUM (1)
32. //这是一个全局条目，说明数据域的数量为三个。
33. 0x95, 0x03, // REPORT_COUNT (3)
34. //这是一个全局条目，说明每个数据域的长度为1个bit。
35. 0x75, 0x01, // REPORT_SIZE (1)
36. //这是一个主条目，说明有3个长度为1bit的数据域（数量和长度
37. //由前面的两个全局条目所定义）用来做为输入，
38. //属性为：Data,Var,Abs。Data表示这些数据可以变动，Var表示
39. //这些数据域是独立的，每个域表示一个意思。Abs表示绝对值。
40. //这样定义的结果就是，第一个数据域bit0表示按键1（左键）是否按下，
41. //第二个数据域bit1表示按键2（右键）是否按下，第三个数据域bit2表示
42. //按键3（中键）是否按下。
43. 0x81, 0x02, // INPUT (Data,Var,Abs)
44. //这是一个全局条目，说明数据域数量为1个
45. 0x95, 0x01, // REPORT_COUNT (1)
46. //这是一个全局条目，说明每个数据域的长度为5bit。
47. 0x75, 0x05, // REPORT_SIZE (5)
48. //这是一个主条目，输入用，由前面两个全局条目可知，长度为5bit，
49. //数量为1个。它的属性为常量（即返回的数据一直是0）。
50. //这个只是为了凑齐一个字节（前面用了3个bit）而填充的一些数据
51. //而已，所以它是没有实际用途的。
52. 0x81, 0x03, // INPUT (Cnst,Var,Abs)
53. //这是一个全局条目，选择用途页为普通桌面Generic Desktop Page(0x01)
54. 0x05, 0x01, // USAGE_PAGE (Generic Desktop)
55. //这是一个局部条目，说明用途为X轴
56. 0x09, 0x30, // USAGE (X)
57. //这是一个局部条目，说明用途为Y轴
58. 0x09, 0x31, // USAGE (Y)
59. //这是一个局部条目，说明用途为滚轮
60. 0x09, 0x38, // USAGE (Wheel)
61. //下面两个为全局条目，说明返回的逻辑最小和最大值。
62. //因为鼠标指针移动时，通常是用相对值来表示的，
63. //相对值的意思就是，当指针移动时，只发送移动量。
64. //往右移动时，X值为正；往下移动时，Y值为正。
65. //对于滚轮，当滚轮往上滚时，值为正。
66. 0x15, 0x81, // LOGICAL_MINIMUM (-127)
67. 0x25, 0x7f, // LOGICAL_MAXIMUM (127)
68. //这是一个全局条目，说明数据域的长度为8bit。
69. 0x75, 0x08, // REPORT_SIZE (8)
70. //这是一个全局条目，说明数据域的个数为3个。
71. 0x95, 0x03, // REPORT_COUNT (3)
72. //这是一个主条目。它说明这三个8bit的数据域是输入用的，
73. //属性为：Data,Var,Rel。Data说明数据是可以变的，Var说明
74. //这些数据域是独立的，即第一个8bit表示X轴，第二个8bit表示
75. //Y轴，第三个8bit表示滚轮。Rel表示这些值是相对值。
76. 0x81, 0x06, // INPUT (Data,Var,Rel)
77. //下面这两个主条目用来关闭前面的集合用。
78. //我们开了两个集合，所以要关两次。bSize为0，所以后面没数据。
79. 0xc0, // END_COLLECTION
80. 0xc0 // END_COLLECTION
81. };
82. //通过上面的报告描述符的定义，我们知道返回的输入报告具有4字节。
83. //第一字节的低3位用来表示按键是否按下的，高5位为常数0，无用。
84. //第二字节表示X轴改的变量，第三字节表示Y轴的改变量，第四字节表示
85. //滚轮的改变量。我们在中断端点1中应该要按照上面的格式返回实际的
86. //鼠标数据。

3.14 报告的返回

1. //函数功能：端点0输入中断处理函数。
2. void UsbEp0In(void)
3. {
4. #ifdef DEBUG0
5. Prints("USB端点0输入中断。\r\n");
6. #endif
7. //读最后发送状态，这将清除端点0的中断标志位
8. D12ReadEndpointLastStatus(1);
9. //发送剩余的字节数
10. UsbEp0SendData();
11. }

1. //函数功能：总线复位中断处理函数。
2. void UsbBusReset(void)
3. {
4. #ifdef DEBUG0
5. Prints("USB总线复位。\r\n");
6. #endif
7. Ep1InIsBusy=0; //复位后端点1输入缓冲区空闲。
8. }

1. if(ConfigValue!=0) //如果已经设置为非0的配置，则可以返回报告数据
2. {
3. LEDs=~KeyPress; //利用板上8个LED显示按键状态，按下时亮
4. if(!Ep1InIsBusy) //如果端点1输入没有处于忙状态，则可以发送数据
5. {
6. KeyCanChange=0; //禁止按键扫描
7. if(KeyUp||KeyDown||KeyPress) //如果有按键事件发生
8. {
9. SendReport(); //则返回报告
10. }
11. KeyCanChange=1; //允许按键扫描
12. }
13. }

3.16本章小结