USB HID 教學 #１(轉載)

作者： -
什麼是 HID Report Descriptor?
HID report descriptor 的用途是定義 reports 的資料格式與使用目的，包括：device 支援多少個 reports, report 的大小，還有 report 中每個 byte 與 bit 的用途。例如，如果是 mouse device，資料會是 mouse movements (滑鼠的移動) 與 button clicks (滑鼠按鍵動作) ；如果是鍵盤，資料會是 keystrokes (按鍵), modifiers (組合鍵或稱輔助鍵) 與 LED Indicators (指示燈) 的輸出狀態。所以，application 只要解讀 report descriptors 便可以知道 report 中的資料是做何種操控 (control) 之用。
HID report descriptor 可以包含多個 reports，而 report 的種類可以分成三種：Input, Output 與 Feature reports。Host 會用 Input report 收資料、用 Output report 送資料，而 Feature report 則是雙向的。
HID 文件
在 http://www.usb.org/developers/hidpage/ 這個頁面中有很多 HID 相關的文件，其中，底下這兩份文件比較重要，是學習 HID 必讀的文件：
HID descriptor tool
同一個頁面上有一支工具，叫做 HID descriptor tool:
這支工具可以用來幫助你產生 report descriptor，是每個寫 report descriptor 的工程師必備的，因為自行翻閱 HID Usage Tables 查表對應代碼以純手工的方式寫 report descriptor 是很累的一件事，用這支工具會省下不少工夫。
HID descriptor tool 內附一些 report descriptors 的範例，在同一個資料夾中副檔名為 .hid 的檔案即是。HID descriptor tool 可以輸出多種格式的檔案，包括 .txt, .inc, .h 等，在打開「另存新檔 ("File > Save as")」這個視窗的時候 ，就可以選擇輸出檔的格式。
以 mouse 為例，打開 mouse.hid 後會看到:
image
▲ HID Descriptor Tool
點選 "File > Save As" 開啟「另存新檔」視窗：
image
在「存檔類型」中選擇 "Header File (*.h)"，按下「儲存」鈕，就會產生包含 reports descriptor 的 mouse.h 檔，內容如下：
01char ReportDescriptor[50] = {
02    0x05, 0x01,                    // USAGE_PAGE (Generic Desktop)
03    0x09, 0x02,                    // USAGE (Mouse)
04    0xa1, 0x01,                    // COLLECTION (Application)
05    0x09, 0x01,                    //   USAGE (Pointer)
06    0xa1, 0x00,                    //   COLLECTION (Physical)
07    0x05, 0x09,                    //     USAGE_PAGE (Button)
08    0x19, 0x01,                    //     USAGE_MINIMUM (Button 1)
09    0x29, 0x03,                    //     USAGE_MAXIMUM (Button 3)
10    0x15, 0x00,                    //     LOGICAL_MINIMUM (0)
11    0x25, 0x01,                    //     LOGICAL_MAXIMUM (1)
12    0x95, 0x03,                    //     REPORT_COUNT (3)
13    0x75, 0x01,                    //     REPORT_SIZE (1)
14    0x81, 0x02,                    //     INPUT (Data,Var,Abs)
15    0x95, 0x01,                    //     REPORT_COUNT (1)
16    0x75, 0x05,                    //     REPORT_SIZE (5)
17    0x81, 0x03,                    //     INPUT (Cnst,Var,Abs)
18    0x05, 0x01,                    //     USAGE_PAGE (Generic Desktop)
19    0x09, 0x30,                    //     USAGE (X)
20    0x09, 0x31,                    //     USAGE (Y)
21    0x15, 0x81,                    //     LOGICAL_MINIMUM (-127)
22    0x25, 0x7f,                    //     LOGICAL_MAXIMUM (127)
23    0x75, 0x08,                    //     REPORT_SIZE (8)
24    0x95, 0x02,                    //     REPORT_COUNT (2)
25    0x81, 0x06,                    //     INPUT (Data,Var,Rel)
26    0xc0,                          //   END_COLLECTION
27    0xc0                           // END_COLLECTION
28};

留言

張貼留言

這個網誌中的熱門文章

python serial 模組使用方法 #1

作者： -
一、概述     pyserial模組封裝了對串列埠的訪問。 二、特性     在支援的平臺上有統一的介面。     通過python屬性訪問串列埠設定。     支援不同的位元組大小、停止位、校驗位和流控設定。     可以有或者沒有接收超時。      類似檔案的API，例如read和write，也支援readline等。     支援二進位制傳輸，沒有null消除，沒有cr-lf轉換。 三、系統要求     python 2.3及以上版本，包括py3k。 四、使用方法和例項 1、匯入pyserial模組 pip install pyserial (for Power shell) import serial 2、開啟序列口 // 開啟串列埠0， 9600，8N1，連線超時0.5秒 import serial ①選擇裝置 ser=serial.Serial(“/dev/ttyUSB0”,9600,timeout=0.5) #使用USB連線序列口 ser=serial.Serial(“/dev/ttyAMA0”,9600,timeout=0.5) #使用樹莓派的GPIO口連線序列口 ser=serial.Serial(1,9600,timeout=0.5)#winsows系統使用com1口連線序列口 ser=serial.Serial(“com1”,9600,timeout=0.5)#winsows系統使用com1口連線序列口 ser=serial.Serial(“/dev/ttyS1”,9600,timeout=0.5)#Linux系統使用com1口連線序列口 print ser.name#列印裝置名稱 print ser.port#列印裝置名 ser.open() #開啟埠 s = ser.read(10)#從埠讀10個位元組 ser.write(“hello”)#向埠寫資料 ser.close()#關閉埠 data = ser.read(20) #是讀20個字元 data = ser.readline() #是讀一行，以/n結束，要是沒有/n就一直讀，阻塞。 data = ser.readlines()和
閱讀完整內容

USB HID 教學 #2 (轉載)

作者： -
這篇是我讀 frank " USnooBie’s USB HID Report Descriptor Tutorial 1 " 一文而寫的筆記，在此我要感謝 frank 的慷慨分享。 mouse 範例 我們將製作一個含有 3 個按鈕和 X, Y 軸移動 (movements) 的標準滑鼠。也就是說，我們要送按鈕跟 X, Y 軸移動的資料給 host。這會需要：一個 bit 代表一個按鈕，一個 byte 代表一個座標軸的移動，移動值是有符號的整數 (signed integer)。所以，我們需要像這樣的資料結構： Bit 3-7 Bit 2 Bit 1 Bit 0 Byte 0 Padding Bits Left Button Middle Button Right Button Byte 1 8 bit signed relative coordinate x Byte 2 8 bit signed relative coordinate Y 在 C 語言中資料結構會是這樣: 1 typedef   struct { 2      uchar   buttonMask; 3      char      dx; 4      char      dy; 5 }report_t; 在我們的 report descriptor 中，首先定義按鈕，總共 3 個按鈕: 1 USAGE_PAGE (Button) 2 USAGE_MINIMUM (Button 1) 3 USAGE_MAXIMUM (Button 3) 按鈕狀態不是 0 就是 1: 1 LOGICAL_MINIMUM (0) 2 LOGICAL_MAXIMUM (1) 3 個按鈕總共 3 個位元: 1 REPORT_COUNT (3) 2 REPORT_SIZE (1) 這個是要送給 host 的變數資料: 1 INPUT (Data,Var,Abs) 得到的結果為： 1 USAGE_PAGE (Button) 2 USAGE_MINIMUM (Bu
閱讀完整內容