C51 COMPILER V7.06   USBCORE                                                               11/16/2008 16:00:31 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.14
  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          //USB設備描述符的定義
  55          code uint8 DeviceDescriptor[0x12]=  //設備描述符為18字節
C51 COMPILER V7.06   USBCORE                                                               11/16/2008 16:00:31 PAGE 2   

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

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

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

 242           
 243           //下面這個主條目用來關閉前面的集合。bSize為0，所以后面沒數據。
 244           0xc0        // END_COLLECTION
 245          };
 246          //通過上面的報告描述符的定義，我們知道返回的輸入報告具有8字節。
 247          //第一字節的8個bit用來表示特殊鍵是否按下（例如Shift、Alt等鍵）。
 248          //第二字節為保留值，值為常量0。第三到第八字節是一個普通鍵鍵值的
 249          //數組，當沒有鍵按下時，全部6個字節值都為0。當只有一個普通鍵按下時，
 250          //這六個字節中的第一字節值即為該按鍵的鍵值（具體的鍵值請看HID的
 251          //用途表文檔），當有多個普通鍵同時按下時，則同時返回這些鍵的鍵值。
 252          //如果按下的鍵太多，則這六個字節都為0xFF（不能返回0x00，這樣會讓
 253          //操作系統認為所有鍵都已經釋放）。至于鍵值在數組中的先后順序是
 254          //無所謂的，操作系統會負責檢查是否有新鍵按下。我們應該在中斷端點1
 255          //中按照上面的格式返回實際的鍵盤數據。另外，報告中還定義了一個字節
 256          //的輸出報告，是用來控制LED情況的。只使用了低7位，高1位是保留值0。
 257          //當某位的值為1時，則表示對應的LED要點亮。操作系統會負責同步各個
 258          //鍵盤之間的LED，例如你有兩塊鍵盤，一塊的數字鍵盤燈亮時，另一塊
 259          //也會跟著亮。鍵盤本身不需要判斷各種LED應該何時亮，它只是等待主機
 260          //發送報告給它，然后根據報告值來點亮相應的LED。我們在端點1輸出中斷
 261          //中讀出這1字節的輸出報告，然后對它取反（因為學習板上的LED是低電平時
 262          //亮），直接發送到LED上。這樣main函數中按鍵點亮LED的代碼就不需要了。
 263          ///////////////////////////報告描述符完畢////////////////////////////
 264          
 265          //USB配置描述符集合的定義
 266          //配置描述符總長度為9+9+9+7+7字節
 267          code uint8 ConfigurationDescriptor[9+9+9+7+7]=
 268          {
 269           /***************配置描述符***********************/
 270           //bLength字段。配置描述符的長度為9字節。
 271           0x09,
 272