📄 usbcore.lst
字号:
C51 COMPILER V8.02 USBCORE 06/17/2010 09:51:39 PAGE 1
C51 COMPILER V8.02, COMPILATION OF MODULE USBCORE
OBJECT MODULE PLACED IN UsbCore.OBJ
COMPILER INVOKED BY: D:\处理软件\keil\C51\BIN\C51.EXE UsbCore.c BROWSE DEBUG OBJECTEXTEND
line level source
1 /******************************************************************
2 本程序只供学习使用，未经作者许可，不得用于其它任何用途
3
4 欢迎光临天祥电子 www.txmcu.cn
5
6 *******************************************************************/
7
8
9 #include "config.h"
10 #include "pdiusbd12.h"
11 #include "uart.h"
12 #include "usbcore.h"
13 #include "led.h"
14
15 idata uint8 Buffer[16]; //读端点0用的缓冲区
16
17 //USB设备请求的各字段
18 uint8 bmRequestType;
19 uint8 bRequest;
20 uint16 wValue;
21 uint16 wIndex;
22 uint16 wLength;
23 //当前发送数据的位置
24 uint8 * pSendData;
25 //需要发送数据的长度
26 uint16 SendLength;
27 //是否需要发送0数据包的标志。在USB控制传输的数据过程中，
28 //当返回的数据包字节数少于最大包长时，会认为数据过程结束。
29 //当请求的字节数比实际需要返回的字节数长，而实际返回的字节
30 //数又刚好是端点0大小的整数倍时，就需要返回一个0长度的数据包
31 //来结束数据过程。因此这里增加一个标志，供程序决定是否需要返回
32 //一个0长度的数据包。
33 uint8 NeedZeroPacket;
34
35 //当前的配置值。只有在设置非0配置后
36 uint8 ConfigValue;
37
38 //端点1缓冲是否忙的标志。当缓冲区中有数据时，该标志为真。
39 //当缓冲区中空闲时，该标志为假。
40 uint8 Ep1InIsBusy;
41
42 //USB设备描述符的定义
43 code uint8 DeviceDescriptor[0x12]= //设备描述符为18字节
44 {
45 //bLength字段。设备描述符的长度为18(0x12)字节
46 0x12,
47
48 //bDescriptorType字段。设备描述符的编号为0x01
49 0x01,
50
51 //bcdUSB字段。这里设置版本为USB1.1，即0x0110。
52 //由于是小端结构，所以低字节在先，即0x10，0x01。
53 0x10,
54 0x01,
55
C51 COMPILER V8.02 USBCORE 06/17/2010 09:51:39 PAGE 2
56 //bDeviceClass字段。我们不在设备描述符中定义设备类，
57 //而在接口描述符中定义设备类，所以该字段的值为0。
58 0x00,
59
60 //bDeviceSubClass字段。bDeviceClass字段为0时，该字段也为0。
61 0x00,
62
63 //bDeviceProtocol字段。bDeviceClass字段为0时，该字段也为0。
64 0x00,
65
66 //bMaxPacketSize0字段。PDIUSBD12的端点0大小的16字节。
67 0x10,
68
69 //idVender字段。厂商ID号，我们这里取0x8888，仅供实验用。
70 //实际产品不能随便使用厂商ID号，必须跟USB协会申请厂商ID号。
71 //注意小端模式，低字节在先。
72 0x88,
73 0x88,
74
75 //idProduct字段。产品ID号，由于是第二个实验，我们这里取0x0002。
76 //注意小端模式，低字节应该在前。
77 0x02,
78 0x00,
79
80 //bcdDevice字段。我们这个USB键盘刚开始做，就叫它1.0版吧，即0x0100。
81 //小端模式，低字节在先。
82 0x00,
83 0x01,
84
85 //iManufacturer字段。厂商字符串的索引值，为了方便记忆和管理，
86 //字符串索引就从1开始吧。
87 0x01,
88
89 //iProduct字段。产品字符串的索引值。刚刚用了1，这里就取2吧。
90 //注意字符串索引值不要使用相同的值。
91 0x02,
92
93 //iSerialNumber字段。设备的序列号字符串索引值。
94 //这里取3就可以了。
95 0x03,
96
97 //bNumConfigurations字段。该设备所具有的配置数。
98 //我们只需要一种配置就行了，因此该值设置为1。
99 0x01
100 };
101 //////////////////////////设备描述符完毕//////////////////////////////
102
103 //USB报告描述符的定义
104 code uint8 ReportDescriptor[]=
105 {
106 //每行开始的第一字节为该条目的前缀，前缀的格式为：
107 //D7~D4：bTag。D3~D2：bType；D1~D0：bSize。以下分别对每个条目注释。
108
109 //这是一个全局（bType为1）条目，将用途页选择为普通桌面Generic Desktop Page(0x01)
110 //后面跟一字节数据（bSize为1），后面的字节数就不注释了，
111 //自己根据bSize来判断。
112 0x05, 0x01, // USAGE_PAGE (Generic Desktop)
113
114 //这是一个局部（bType为2）条目，说明接下来的集合用途用于键盘
115 0x09, 0x06, // USAGE (Keyboard)
116
117 //这是一个主条目（bType为0）条目，开集合，后面跟的数据0x01表示
C51 COMPILER V8.02 USBCORE 06/17/2010 09:51:39 PAGE 3
118 //该集合是一个应用集合。它的性质在前面由用途页和用途定义为
119 //普通桌面用的键盘。
120 0xa1, 0x01, // COLLECTION (Application)
121
122 //这是一个全局条目，选择用途页为键盘（Keyboard/Keypad(0x07)）
123 0x05, 0x07, // USAGE_PAGE (Keyboard/Keypad)
124
125 //这是一个局部条目，说明用途的最小值为0xe0。实际上是键盘左Ctrl键。
126 //具体的用途值可在HID用途表中查看。
127 0x19, 0xe0, // USAGE_MINIMUM (Keyboard LeftControl)
128
129 //这是一个局部条目，说明用途的最大值为0xe7。实际上是键盘右GUI键。
130 0x29, 0xe7, // USAGE_MAXIMUM (Keyboard Right GUI)
131
132 //这是一个全局条目，说明返回的数据的逻辑值（就是我们返回的数据域的值）
133 //最小为0。因为我们这里用Bit来表示一个数据域，因此最小为0，最大为1。
134 0x15, 0x00, // LOGICAL_MINIMUM (0)
135
136 //这是一个全局条目，说明逻辑值最大为1。
137 0x25, 0x01, // LOGICAL_MAXIMUM (1)
138
139 //这是一个全局条目，说明数据域的数量为八个。
140 0x95, 0x08, // REPORT_COUNT (8)
141
142 //这是一个全局条目，说明每个数据域的长度为1个bit。
143 0x75, 0x01, // REPORT_SIZE (1)
144
145 //这是一个主条目，说明有8个长度为1bit的数据域（数量和长度
146 //由前面的两个全局条目所定义）用来做为输入，
147 //属性为：Data,Var,Abs。Data表示这些数据可以变动，Var表示
148 //这些数据域是独立的，每个域表示一个意思。Abs表示绝对值。
149 //这样定义的结果就是，当某个域的值为1时，就表示对应的键按下。
150 //bit0就对应着用途最小值0xe0，bit7对应着用途最大值0xe7。
151 0x81, 0x02, // INPUT (Data,Var,Abs)
152
153 //这是一个全局条目，说明数据域数量为1个
154 0x95, 0x01, // REPORT_COUNT (1)
155
156 //这是一个全局条目，说明每个数据域的长度为8bit。
157 0x75, 0x08, // REPORT_SIZE (8)
158
159 //这是一个主条目，输入用，由前面两个全局条目可知，长度为8bit，
160 //数量为1个。它的属性为常量（即返回的数据一直是0）。
161 //该字节是保留字节（保留给OEM使用）。
162 0x81, 0x03, // INPUT (Cnst,Var,Abs)
163
164 //这是一个全局条目。定义位域数量为6个。
165 0x95, 0x06, // REPORT_COUNT (6)
166
167 //这是一个全局条目。定义每个位域长度为8bit。
168 //其实这里这个条目不要也是可以的，因为在前面已经有一个定义
169 //长度为8bit的全局条目了。
170 0x75, 0x08, // REPORT_SIZE (8)
171
172 //这是一个全局条目，定义逻辑最小值为0。
173 //同上，这里这个全局条目也是可以不要的，因为前面已经有一个
174 //定义逻辑最小值为0的全局条目了。
175 0x15, 0x00, // LOGICAL_MINIMUM (0)
176
177 //这是一个全局条目，定义逻辑最大值为255。
178 0x25, 0xFF, // LOGICAL_MAXIMUM (255)
179
C51 COMPILER V8.02 USBCORE 06/17/2010 09:51:39 PAGE 4
180 //这是一个全局条目，选择用途页为键盘。
181 //前面已经选择过用途页为键盘了，所以该条目不要也可以。
182 0x05, 0x07, // USAGE_PAGE (Keyboard/Keypad)
183
184 //这是一个局部条目，定义用途最小值为0（0表示没有键按下）
185 0x19, 0x00, // USAGE_MINIMUM (Reserved (no event indicated))
186
187 //这是一个局部条目，定义用途最大值为0x65
188 0x29, 0x65, // USAGE_MAXIMUM (Keyboard Application)
189
190 //这是一个主条目。它说明这六个8bit的数据域是输入用的，
191 //属性为：Data,Ary,Abs。Data说明数据是可以变的，Ary说明
192 //这些数据域是一个数组，即每个8bit都可以表示某个键值，
193 //如果按下的键太多（例如超过这里定义的长度或者键盘本身无法
194 //扫描出按键情况时），则这些数据返回全1（二进制），表示按键无效。
195 //Abs表示这些值是绝对值。
196 0x81, 0x00, // INPUT (Data,Ary,Abs)
197
198 //以下为输出报告的描述
199 //逻辑最小值前面已经有定义为0了，这里可以省略。
200 //这是一个全局条目，说明逻辑值最大为1。
201 0x25, 0x01, // LOGICAL_MAXIMUM (1)
202
203 //这是一个全局条目，说明数据域数量为5个。
204 0x95, 0x05, // REPORT_COUNT (5)
205
206 //这是一个全局条目，说明数据域的长度为1bit。
207 0x75, 0x01, // REPORT_SIZE (1)
208
209 //这是一个全局条目，说明使用的用途页为指示灯（LED）
210 0x05, 0x08, // USAGE_PAGE (LEDs)
211
212 //这是一个局部条目，说明用途最小值为数字键盘灯。
213 0x19, 0x01, // USAGE_MINIMUM (Num Lock)
214
215 //这是一个局部条目，说明用途最大值为Kana灯。
216 0x29, 0x05, // USAGE_MAXIMUM (Kana)
217
218 //这是一个主条目。定义输出数据，即前面定义的5个LED。
219 0x91, 0x02, // OUTPUT (Data,Var,Abs)
220
221 //这是一个全局条目。定义位域数量为1个。
222 0x95, 0x01, // REPORT_COUNT (1)
223
224 //这是一个全局条目。定义位域长度为3bit。
225 0x75, 0x03, // REPORT_SIZE (3)
226
227 //这是一个主条目，定义输出常量，前面用了5bit，所以这里需要
228 //3个bit来凑成一字节。
229 0x91, 0x03, // OUTPUT (Cnst,Var,Abs)
230
231 //下面这个主条目用来关闭前面的集合。bSize为0，所以后面没数据。
232 0xc0 // END_COLLECTION
233 };
234 //通过上面的报告描述符的定义，我们知道返回的输入报告具有8字节。
235 //第一字节的8个bit用来表示特殊键是否按下（例如Shift、Alt等键）。
236 //第二字节为保留值，值为常量0。第三到第八字节是一个普通键键值的
237 //数组，当没有键按下时，全部6个字节值都为0。当只有一个普通键按下时，
238 //这六个字节中的第一字节值即为该按键的键值（具体的键值请看HID的
239 //用途表文档），当有多个普通键同时按下时，则同时返回这些键的键值。
240 //如果按下的键太多，则这六个字节都为0xFF（不能返回0x00，这样会让
241 //操作系统认为所有键都已经释放）。至于键值在数组中的先后顺序是
C51 COMPILER V8.02 USBCORE 06/17/2010 09:51:39 PAGE 5
242 //无所谓的，操作系统会负责检查是否有新键按下。我们应该在中断端点1
243 //中按照上面的格式返回实际的键盘数据。另外，报告中还定义了一个字节
244 //的输出报告，是用来控制LED情况的。只使用了低7位，高1位是保留值0。
245 //当某位的值为1时，则表示对应的LED要点亮。操作系统会负责同步各个
246 //键盘之间的LED，例如你有两块键盘，一块的数字键盘灯亮时，另一块
247 //也会跟着亮。键盘本身不需要判断各种LED应该何时亮，它只是等待主机
248 //发送报告给它，然后根据报告值来点亮相应的LED。我们在端点1输出中断
249 //中读出这1字节的输出报告，然后对它取反（因为学习板上的LED是低电平时
250 //亮），直接发送到LED上。这样main函数中按键点亮LED的代码就不需要了。
251 ///////////////////////////报告描述符完毕////////////////////////////
252
253 //USB配置描述符集合的定义
254 //配置描述符总长度为9+9+9+7+7字节
255 code uint8 ConfigurationDescriptor[9+9+9+7+7]=
256 {
257 /***************配置描述符***********************/
258 //bLength字段。配置描述符的长度为9字节。
259 0x09,
260
261 //bDescriptorType字段。配置描述符编号为0x02。
262 0x02,
263
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -