usbcore.lst

此源代码为双报表法USB键盘鼠标开发源代码

 242           //这是一个全局条目。定义位域长度为3bit。
 243           0x75, 0x03, //   REPORT_SIZE (3)
 244           
 245           //这是一个主条目，定义输出常量，前面用了5bit，所以这里需要
 246           //3个bit来凑成一字节。
 247           0x91, 0x03, //   OUTPUT (Cnst,Var,Abs)
 248           
 249           //下面这个主条目用来关闭前面的集合。bSize为0，所以后面没数据。
 250           0xc0,        // END_COLLECTION
 251          //以下注释不包括第一字节报告ID。
 252          //通过上面的报告描述符的定义，我们知道返回的输入报告具有8字节。
 253          //第一字节的8个bit用来表示特殊键是否按下（例如Shift、Alt等键）。
 254          //第二字节为保留值，值为常量0。第三到第八字节是一个普通键键值的
 255          //数组，当没有键按下时，全部6个字节值都为0。当只有一个普通键按下时，
 256          //这六个字节中的第一字节值即为该按键的键值（具体的键值请看HID的
 257          //用途表文档），当有多个普通键同时按下时，则同时返回这些键的键值。
 258          //如果按下的键太多，则这六个字节都为0xFF（不能返回0x00，这样会让
 259          //操作系统认为所有键都已经释放）。至于键值在数组中的先后顺序是
 260          //无所谓的，操作系统会负责检查是否有新键按下。我们应该在中断端点1
 261          //中按照上面的格式返回实际的键盘数据。另外，报告中还定义了一个字节
 262          //的输出报告，是用来控制LED情况的。只使用了低7位，高1位是保留值0。
 263          //当某位的值为1时，则表示对应的LED要点亮。操作系统会负责同步各个
 264          //键盘之间的LED，例如你有两块键盘，一块的数字键盘灯亮时，另一块
 265          //也会跟着亮。键盘本身不需要判断各种LED应该何时亮，它只是等待主机
 266          //发送报告给它，然后根据报告值来点亮相应的LED。我们在端点1输出中断
 267          //中读出这1字节的输出报告，然后对它取反（因为学习板上的LED是低电平时
 268          //亮），直接发送到LED上。这样main函数中按键点亮LED的代码就不需要了。
 269          
 270          /************************USB鼠标部分报告描述符**********************/
 271          /*******************************************************************/
 272          
 273           //这是一个全局（bType为1）条目，选择用途页为普通桌面Generic Desktop Page(0x01)
 274           0x05, 0x01, // USAGE_PAGE (Generic Desktop)
 275           
 276           //这是一个局部（bType为2）条目，说明接下来的应用集合用途用于鼠标
 277           0x09, 0x02, // USAGE (Mouse)
 278           
 279           //这是一个主条目（bType为0）条目，开集合，后面跟的数据0x01表示
 280           //该集合是一个应用集合。它的性质在前面由用途页和用途定义为
 281           //普通桌面用的鼠标。
 282           0xa1, 0x01, // COLLECTION (Application)
 283           
 284           //报告ID，这里定义鼠标报告的ID为2
 285           0x85, 0x02, //Report ID (2)
 286           
 287           //这是一个局部条目。说明用途为指针集合
 288           0x09, 0x01, //   USAGE (Pointer)
 289           
 290           //这是一个主条目，开集合，后面跟的数据0x00表示该集合是一个
 291           //物理集合，用途由前面的局部条目定义为指针集合。
 292           0xa1, 0x00, //   COLLECTION (Physical)
 293           
 294           //这是一个全局条目，选择用途页为按键（Button Page(0x09)）
 295           0x05, 0x09, //     USAGE_PAGE (Button)
 296           
 297           //这是一个局部条目，说明用途的最小值为1。实际上是鼠标左键。
 298           0x19, 0x01, //     USAGE_MINIMUM (Button 1)
 299           
 300           //这是一个局部条目，说明用途的最大值为3。实际上是鼠标中键。
 301           0x29, 0x03, //     USAGE_MAXIMUM (Button 3)
 302           
 303           //这是一个全局条目，说明返回的数据的逻辑值（就是我们返回的数据域的值啦）
C51 COMPILER V7.06   USBCORE                                                               11/16/2008 16:00:01 PAGE 6   

 304           //最小为0。因为我们这里用Bit来表示一个数据域，因此最小为0，最大为1。
 305           0x15, 0x00, //     LOGICAL_MINIMUM (0)
 306           
 307           //这是一个全局条目，说明逻辑值最大为1。
 308           0x25, 0x01, //     LOGICAL_MAXIMUM (1)
 309           
 310           //这是一个全局条目，说明数据域的数量为三个。
 311           0x95, 0x03, //     REPORT_COUNT (3)
 312           
 313           //这是一个全局条目，说明每个数据域的长度为1个bit。
 314           0x75, 0x01, //     REPORT_SIZE (1)
 315           
 316           //这是一个主条目，说明有3个长度为1bit的数据域（数量和长度
 317           //由前面的两个全局条目所定义）用来做为输入，
 318           //属性为：Data,Var,Abs。Data表示这些数据可以变动，Var表示
 319           //这些数据域是独立的，每个域表示一个意思。Abs表示绝对值。
 320           //这样定义的结果就是，第一个数据域bit0表示按键1（左键）是否按下，
 321           //第二个数据域bit1表示按键2（右键）是否按下，第三个数据域bit2表示
 322           //按键3（中键）是否按下。
 323           0x81, 0x02, //     INPUT (Data,Var,Abs)
 324           
 325           //这是一个全局条目，说明数据域数量为1个
 326           0x95, 0x01, //     REPORT_COUNT (1)
 327           
 328           //这是一个全局条目，说明每个数据域的长度为5bit。
 329           0x75, 0x05, //     REPORT_SIZE (5)
 330           
 331           //这是一个主条目，输入用，由前面两个全局条目可知，长度为5bit，
 332           //数量为1个。它的属性为常量（即返回的数据一直是0）。
 333           //这个只是为了凑齐一个字节（前面用了3个bit）而填充的一些数据
 334           //而已，所以它是没有实际用途的。
 335           0x81, 0x03, //     INPUT (Cnst,Var,Abs)
 336           
 337           //这是一个全局条目，选择用途页为普通桌面Generic Desktop Page(0x01)
 338           0x05, 0x01, //     USAGE_PAGE (Generic Desktop)
 339           
 340           //这是一个局部条目，说明用途为X轴
 341           0x09, 0x30, //     USAGE (X)
 342           
 343           //这是一个局部条目，说明用途为Y轴
 344           0x09, 0x31, //     USAGE (Y)
 345           
 346           //这是一个局部条目，说明用途为滚轮
 347           0x09, 0x38, //     USAGE (Wheel)
 348           
 349           //下面两个为全局条目，说明返回的逻辑最小和最大值。
 350           //因为鼠标指针移动时，通常是用相对值来表示的，
 351           //相对值的意思就是，当指针移动时，只发送移动量。
 352           //往右移动时，X值为正；往下移动时，Y值为正。
 353           //对于滚轮，当滚轮往上滚时，值为正。
 354           0x15, 0x81, //     LOGICAL_MINIMUM (-127)
 355           0x25, 0x7f, //     LOGICAL_MAXIMUM (127)
 356           
 357           //这是一个全局条目，说明数据域的长度为8bit。
 358           0x75, 0x08, //     REPORT_SIZE (8)
 359           
 360           //这是一个全局条目，说明数据域的个数为3个。
 361           0x95, 0x03, //     REPORT_COUNT (3)
 362           
 363           //这是一个主条目。它说明这三个8bit的数据域是输入用的，
 364           //属性为：Data,Var,Rel。Data说明数据是可以变的，Var说明
 365           //这些数据域是独立的，即第一个8bit表示X轴，第二个8bit表示
C51 COMPILER V7.06   USBCORE                                                               11/16/2008 16:00:01 PAGE 7   

 366           //Y轴，第三个8bit表示滚轮。Rel表示这些值是相对值。
 367           0x81, 0x06, //     INPUT (Data,Var,Rel)
 368           
 369           //下面这两个主条目用来关闭前面的集合用。
 370           //我们开了两个集合，所以要关两次。bSize为0，所以后面没数据。
 371           0xc0,       //   END_COLLECTION
 372           0xc0        // END_COLLECTION
 373          //以下注释不包括第一字节报告ID。
 374          //通过上面的报告描述符的定义，我们知道返回的输入报告具有4字节。
 375          //第一字节的低3位用来表示按键是否按下的，高5位为常数0，无用。
 376          //第二字节表示X轴改的变量，第三字节表示Y轴的改变量，第四字节表示
 377          //滚轮的改变量。我们在中断端点1中应该要按照上面的格式返回实际的
 378          //鼠标数据。
 379          };
 380          //由于该报告使用了报告ID，因此报告在返回时，需要在最前面增加
 381          //一字节的报告ID。当报告ID为1时，返回的数据是键盘数据；
 382          //当报告ID为2时，返回的数据是鼠标数据。
 383          ///////////////////////////报告描述符完毕////////////////////////////
 384          
 385          //USB配置描述符集合的定义
 386          //配置描述符总长度为9+9+9+7+7字节
 387          code uint8 ConfigurationDescriptor[9+9+9+7+7]=
 388          {
 389           /***************配置描述符***********************/
 390           //bLength字段。配置描述符的长度为9字节。
 391           0x09,
 392           
 393           //bDescriptorType字段。配置描述符编号为0x02。
 394           0x02,
 395           
 396           //wTotalLength字段。配置描述符集合的总长度，
 397           //包括配置描述符本身、接口描述符、类描述符、端点描述符等。
 398           sizeof(ConfigurationDescriptor)&0xFF, //低字节
 399           (sizeof(ConfigurationDescriptor)>>8)&0xFF, //高字节
 400           
 401           //bNumInterfaces字段。该配置包含的接口数，只有一个接口。
 402           0x01,
 403           
 404           //bConfiguration字段。该配置的值为1。
 405           0x01,
 406           
 407           //iConfigurationz字段，该配置的字符串索引。这里没有，为0。
 408           0x00,
 409           
 410           //bmAttributes字段，该设备的属性。由于我们的板子是总线供电的，
 411           //并且我们不想实现远程唤醒的功能，所以该字段的值为0x80。
 412           0x80,
 413           
 414           //bMaxPower字段，该设备需要的最大电流量。由于我们的板子
 415           //需要的电流不到100mA，因此我们这里设置为100mA。由于每单位
 416           //电流为2mA，所以这里设置为50(0x32)。
 417           0x32,
 418           
 419           /*******************接口描述符*********************/
 420           //bLength字段。接口描述符的长度为9字节。
 421           0x09,
 422           
 423           //bDescriptorType字段。接口描述符的编号为0x04。
 424           0x04,
 425           
 426           //bInterfaceNumber字段。该接口的编号，第一个接口，编号为0。
 427           0x00,
C51 COMPILER V7.06   USBCORE                                                               11/16/2008 16:00:01 PAGE 8   

 428           
 429           //bAlternateSetting字段。该接口的备用编号，为0。
 430           0x00,
 431           
 432           //bNumEndpoints字段。非0端点的数目。由于USB键盘需要二个
 433           //中断端点（一个输入一个输出），因此该值为2。
 434           0x02,
 435           
 436           //bInterfaceClass字段。该接口所使用的类。USB键盘是HID类，
 437           //HID类的编码为0x03。
 438           0x03,
 439           
 440           //bInterfaceSubClass字段。该接口所使用的子类。在HID1.1协议中，
 441           //只规定了一种子类：支持BIOS引导启动的子类。
 442           //USB键盘、鼠标属于该子类，子类代码为0x01。
 443           0x01,
 444           
 445           //bInterfaceProtocol字段。如果子类为支持引导启动的子类，
 446           //则协议可选择鼠标和键盘。键盘代码为0x01，鼠标代码为0x02。
 447           0x01,
 448           
 449           //iConfiguration字段。该接口的字符串索引值。这里没有，为0。
 450           0x00,
 451           
 452           /******************HID描述符************************/
 453           //bLength字段。本HID描述符下只有一个下级描述符。所以长度为9字节。
 454           0x09,
 455           
 456           //bDescriptorType字段。HID描述符的编号为0x21。
 457           0x21,
 458           
 459           //bcdHID字段。本协议使用的HID1.1协议。注意低字节在先。
 460           0x10,
 461           0x01,
 462           
 463           //bCountyCode字段。设备适用的国家代码，这里选择为美国，代码0x21。
 464           0x21,
 465           
 466           //bNumDescriptors字段。下级描述符的数目。我们只有一个报告描述符。
 467           0x01,
 468           
 469           //bDescritporType字段。下级描述符的类型，为报告描述符，编号为0x22。
 470           0x22,
 471           
 472           //bDescriptorLength字段。下级描述符的长度。下级描述符为报告描述符。
 473           sizeof(ReportDescriptor)&0xFF,
 474           (sizeof(ReportDescriptor)>>8)&0xFF,
 475           
 476           /**********************输入端点描述符***********************/
 477           //bLength字段。端点描述符长度为7字节。
 478           0x07,
 479           
 480           //bDescriptorType字段。端点描述符编号为0x05。
 481           0x05,
 482           
 483           //bEndpointAddress字段。端点的地址。我们使用D12的输入端点1。
 484           //D7位表示数据方向，输入端点D7为1。所以输入端点1的地址为0x81。
 485           0x81,
 486           
 487           //bmAttributes字段。D1~D0为端点传输类型选择。
 488           //该端点为中断端点。中断端点的编号为3。其它位保留为0。
 489           0x03,
C51 COMPILER V7.06   USBCORE                                                               11/16/2008 16:00:01 PAGE 9   

 490           
 491           //wMaxPacketSize字段。该端点的最大包长。端点1的最大包长为16字节。