C51 COMPILER V7.06   USBCORE                                                               11/16/2008 15:59:36 PAGE 1   


C51 COMPILER V7.06, COMPILATION OF MODULE USBCORE
OBJECT MODULE PLACED IN UsbCore.OBJ
COMPILER INVOKED BY: d:\Keil\C51\BIN\C51.EXE UsbCore.c BROWSE DEBUG OBJECTEXTEND TABS(1)

stmt level    source

   1          /******************************************************************
   2             本程序只供學習使用，未經作者許可，不得用于其它任何用途
   3             
   4                  歡迎訪問我的USB專區：http://group.ednchina.com/93/
   5                  歡迎訪問我的blog：   http://www.ednchina.com/blog/computer00
   6                                       http://computer00.21ic.org
   7          
   8                  感謝PCB贊助商——電子園： http://bbs.cepark.com/
   9          
  10          UsbCore.c file
  11          
  12          作者：電腦圈圈
  13          建立日期: 2008.06.29
  14          修改日期: 2008.07.16
  15          版本：V1.1
  16          版權所有，盜版必究。
  17          Copyright(C) 電腦圈圈 2008-2018
  18          All rights reserved            
  19          *******************************************************************/
  20          
  21          #include "config.h"
  22          #include "pdiusbd12.h"
  23          #include "uart.h"
  24          #include "usbcore.h"
  25          #include "led.h"
  26          
  27          idata uint8 Buffer[16];  //讀端點0用的緩沖區
  28          
  29          //USB設備請求的各字段
  30          uint8  bmRequestType;
  31          uint8  bRequest;
  32          uint16 wValue;
  33          uint16 wIndex;
  34          uint16 wLength;
  35          //當前發送數據的位置
  36          uint8 * pSendData;
  37          //需要發送數據的長度
  38          uint16 SendLength;
  39          //是否需要發送0數據包的標志。在USB控制傳輸的數據過程中，
  40          //當返回的數據包字節數少于最大包長時，會認為數據過程結束。
  41          //當請求的字節數比實際需要返回的字節數長，而實際返回的字節
  42          //數又剛好是端點0大小的整數倍時，就需要返回一個0長度的數據包
  43          //來結束數據過程。因此這里增加一個標志，供程序決定是否需要返回
  44          //一個0長度的數據包。
  45          uint8 NeedZeroPacket;
  46          
  47          //當前的配置值。只有在設置非0配置后
  48          uint8 ConfigValue;
  49          
  50          //端點1緩沖是否忙的標志。當緩沖區中有數據時，該標志為真。
  51          //當緩沖區中空閑時，該標志為假。
  52          uint8 Ep1InIsBusy;
  53          
  54          //端點2緩沖是否忙的標志。當緩沖區中有數據時，該標志為真。
  55          //當緩沖區中空閑時，該標志為假。
C51 COMPILER V7.06   USBCORE                                                               11/16/2008 15:59:36 PAGE 2   

  56          uint8 Ep2InIsBusy;
  57          
  58          //USB設備描述符的定義
  59          code uint8 DeviceDescriptor[0x12]=  //設備描述符為18字節
  60          {
  61          //bLength字段。設備描述符的長度為18(0x12)字節
  62           0x12,
  63           
  64          //bDescriptorType字段。設備描述符的編號為0x01
  65           0x01,
  66           
  67          //bcdUSB字段。這里設置版本為USB1.1，即0x0110。
  68          //由于是小端結構，所以低字節在先，即0x10，0x01。
  69           0x10,
  70           0x01,
  71           
  72          //bDeviceClass字段。我們不在設備描述符中定義設備類，
  73          //而在接口描述符中定義設備類，所以該字段的值為0。
  74           0x00,
  75           
  76          //bDeviceSubClass字段。bDeviceClass字段為0時，該字段也為0。
  77           0x00,
  78           
  79          //bDeviceProtocol字段。bDeviceClass字段為0時，該字段也為0。
  80           0x00,
  81           
  82          //bMaxPacketSize0字段。PDIUSBD12的端點0大小的16字節。
  83           0x10,
  84           
  85          //idVender字段。廠商ID號，我們這里取0x8888，僅供實驗用。
  86          //實際產品不能隨便使用廠商ID號，必須跟USB協會申請廠商ID號。
  87          //注意小端模式，低字節在先。
  88           0x88,
  89           0x88,
  90           
  91          //idProduct字段。產品ID號，由于是第四個實驗，我們這里取0x0004。
  92          //注意小端模式，低字節應該在前。
  93           0x04,
  94           0x00,
  95           
  96          //bcdDevice字段。取1.0版，即0x0100。
  97          //小端模式，低字節在先。
  98           0x00,
  99           0x01,
 100           
 101          //iManufacturer字段。廠商字符串的索引值，為了方便記憶和管理，
 102          //字符串索引就從1開始。
 103           0x01,
 104          
 105          //iProduct字段。產品字符串的索引值。剛剛用了1，這里就取2吧。
 106          //注意字符串索引值不要使用相同的值。
 107           0x02,
 108           
 109          //iSerialNumber字段。設備的序列號字符串索引值。
 110          //這里取3就可以了。
 111           0x03,
 112          
 113          //bNumConfigurations字段。該設備所具有的配置數。
 114          //我們只需要一種配置就行了，因此該值設置為1。
 115           0x01
 116          };
 117          //////////////////////////設備描述符完畢//////////////////////////////
C51 COMPILER V7.06   USBCORE                                                               11/16/2008 15:59:36 PAGE 3   

 118          
 119          //USB鍵盤報告描述符的定義
 120          code uint8 KeyboardReportDescriptor[]=
 121          {
 122           //每行開始的第一字節為該條目的前綴，前綴的格式為：
 123           //D7~D4：bTag。D3~D2：bType；D1~D0：bSize。以下分別對每個條目注釋。
 124           
 125           //這是一個全局（bType為1）條目，將用途頁選擇為普通桌面Generic Desktop Page(0x01)
 126           //后面跟一字節數據（bSize為1），后面的字節數就不注釋了，
 127           //自己根據bSize來判斷。
 128           0x05, 0x01, // USAGE_PAGE (Generic Desktop)
 129           
 130           //這是一個局部（bType為2）條目，說明接下來的集合用途用于鍵盤
 131           0x09, 0x06, // USAGE (Keyboard)
 132           
 133           //這是一個主條目（bType為0）條目，開集合，后面跟的數據0x01表示
 134           //該集合是一個應用集合。它的性質在前面由用途頁和用途定義為
 135           //普通桌面用的鍵盤。
 136           0xa1, 0x01, // COLLECTION (Application)
 137           
 138           //報告ID，這里定義鍵盤報告的ID為1（報告ID 0是保留的）
 139           //為了減少程序的修改量，這里依然定義一個報告ID。
 140           0x85, 0x01, //Report ID (1)
 141           
 142           //這是一個全局條目，選擇用途頁為鍵盤（Keyboard/Keypad(0x07)）
 143           0x05, 0x07, //     USAGE_PAGE (Keyboard/Keypad)
 144          
 145           //這是一個局部條目，說明用途的最小值為0xe0。實際上是鍵盤左Ctrl鍵。
 146           //具體的用途值可在HID用途表中查看。
 147           0x19, 0xe0, //     USAGE_MINIMUM (Keyboard LeftControl)
 148           
 149           //這是一個局部條目，說明用途的最大值為0xe7。實際上是鍵盤右GUI鍵。
 150           0x29, 0xe7, //     USAGE_MAXIMUM (Keyboard Right GUI)
 151           
 152           //這是一個全局條目，說明返回的數據的邏輯值（就是我們返回的數據域的值）
 153           //最小為0。因為我們這里用Bit來表示一個數據域，因此最小為0，最大為1。
 154           0x15, 0x00, //     LOGICAL_MINIMUM (0)
 155           
 156           //這是一個全局條目，說明邏輯值最大為1。
 157           0x25, 0x01, //     LOGICAL_MAXIMUM (1)
 158           
 159           //這是一個全局條目，說明數據域的數量為八個。
 160           0x95, 0x08, //     REPORT_COUNT (8)
 161           
 162           //這是一個全局條目，說明每個數據域的長度為1個bit。
 163           0x75, 0x01, //     REPORT_SIZE (1)
 164           
 165           //這是一個主條目，說明有8個長度為1bit的數據域（數量和長度
 166           //由前面的兩個全局條目所定義）用來做為輸入，
 167           //屬性為：Data,Var,Abs。Data表示這些數據可以變動，Var表示
 168           //這些數據域是獨立的，每個域表示一個意思。Abs表示絕對值。
 169           //這樣定義的結果就是，當某個域的值為1時，就表示對應的鍵按下。
 170           //bit0就對應著用途最小值0xe0，bit7對應著用途最大值0xe7。
 171           0x81, 0x02, //     INPUT (Data,Var,Abs)
 172           
 173           //這是一個全局條目，說明數據域數量為1個
 174           0x95, 0x01, //     REPORT_COUNT (1)
 175           
 176           //這是一個全局條目，說明每個數據域的長度為8bit。
 177           0x75, 0x08, //     REPORT_SIZE (8)
 178           
 179           //這是一個主條目，輸入用，由前面兩個全局條目可知，長度為8bit，
C51 COMPILER V7.06   USBCORE                                                               11/16/2008 15:59:36 PAGE 4   

 180           //數量為1個。它的屬性為常量（即返回的數據一直是0）。
 181           //該字節是保留字節（保留給OEM使用）。
 182           0x81, 0x03, //     INPUT (Cnst,Var,Abs)
 183           
 184           //這是一個全局條目。定義位域數量為6個。
 185           0x95, 0x06, //   REPORT_COUNT (6)
 186           
 187           //這是一個全局條目。定義每個位域長度為8bit。
 188           //其實這里這個條目不要也是可以的，因為在前面已經有一個定義
 189           //長度為8bit的全局條目了。
 190           0x75, 0x08, //   REPORT_SIZE (8)
 191           
 192           //這是一個全局條目，定義邏輯最小值為0。
 193           //同上，這里這個全局條目也是可以不要的，因為前面已經有一個
 194           //定義邏輯最小值為0的全局條目了。
 195           0x15, 0x00, //   LOGICAL_MINIMUM (0)
 196           
 197           //這是一個全局條目，定義邏輯最大值為255。
 198           0x25, 0xFF, //   LOGICAL_MAXIMUM (255)
 199           
 200           //這是一個全局條目，選擇用途頁為鍵盤。
 201           //前面已經選擇過用途頁為鍵盤了，所以該條目不要也可以。
 202           0x05, 0x07, //   USAGE_PAGE (Keyboard/Keypad)
 203           
 204           //這是一個局部條目，定義用途最小值為0（0表示沒有鍵按下）
 205           0x19, 0x00, //   USAGE_MINIMUM (Reserved (no event indicated))
 206           
 207           //這是一個局部條目，定義用途最大值為0x65
 208           0x29, 0x65, //   USAGE_MAXIMUM (Keyboard Application)
 209           
 210           //這是一個主條目。它說明這六個8bit的數據域是輸入用的，
 211           //屬性為：Data,Ary,Abs。Data說明數據是可以變的，Ary說明
 212           //這些數據域是一個數組，即每個8bit都可以表示某個鍵值，
 213           //如果按下的鍵太多（例如超過這里定義的長度或者鍵盤本身無法
 214           //掃描出按鍵情況時），則這些數據返回全1（二進制），表示按鍵無效。
 215           //Abs表示這些值是絕對值。
 216           0x81, 0x00, //     INPUT (Data,Ary,Abs)
 217          
 218           //以下為輸出報告的描述
 219           //邏輯最小值前面已經有定義為0了，這里可以省略。 
 220           //這是一個全局條目，說明邏輯值最大為1。
 221           0x25, 0x01, //     LOGICAL_MAXIMUM (1)
 222           
 223           //這是一個全局條目，說明數據域數量為5個。 
 224           0x95, 0x05, //   REPORT_COUNT (5)
 225           
 226           //這是一個全局條目，說明數據域的長度為1bit。
 227           0x75, 0x01, //   REPORT_SIZE (1)
 228           
 229           //這是一個全局條目，說明使用的用途頁為指示燈（LED）
 230           0x05, 0x08, //   USAGE_PAGE (LEDs)
 231           
 232           //這是一個局部條目，說明用途最小值為數字鍵盤燈。
 233           0x19, 0x01, //   USAGE_MINIMUM (Num Lock)
 234           
 235           //這是一個局部條目，說明用途最大值為Kana燈。
 236           0x29, 0x05, //   USAGE_MAXIMUM (Kana)
 237           
 238           //這是一個主條目。定義輸出數據，即前面定義的5個LED。
 239           0x91, 0x02, //   OUTPUT (Data,Var,Abs)
 240           
 241           //這是一個全局條目。定義位域數量為1個。
C51 COMPILER V7.06   USBCORE                                                               11/16/2008 15:59:36 PAGE 5   

 242           0x95, 0x01, //   REPORT_COUNT (1)