李皇諦>幫助文檔>HID協議速查手冊 - 萌娘百科萬物皆可萌的百科全書

短項目數據格式
（此處示例為2位元組報文）
數據報送順序先報→後報
報頭	報文
報頭編碼	報頭分類	數據長度	報文第1位元組	報文第0位元組
{{Ptl}}模板已棄用。	{{Ptl}}模板已棄用。	{{Ptl}}模板已棄用。	{{Ptl}}模板已棄用。	{{Ptl}}模板已棄用。	{{Ptl}}模板已棄用。	{{Ptl}}模板已棄用。	{{Ptl}}模板已棄用。	01H	00H

「報頭」和「報文」的區別
【舉例：個人信息表（摘錄）】
↓「報頭」	↓「報文」
姓名	李皇諦
性別	男性
個性簽名	男人有夢，不過如三：至親、摯愛、致遠。
個人持有帳戶主頁	嗶哩嗶哩 https://space.bilibili.com/7187544 萌娘百科 https://zh.moegirl.tw/User:%E6%9D%8E%E7%9A%87%E8%B0%9B

「內存行」名詞註解
學習HID乃至USB之前，必須精通數電基礎。「內存」一般指DRAM緩存，「內存」所存放的數據「內存行」是其構建的基礎單位。「內存行」表示存放對應數據的一組邏輯位，如無特殊說明，一行內存為1位元組，佔用8個邏輯位。在單片機中，「寄存器」是「內存行」的一種類型。一個邏輯位只有高電平和低電平兩種狀態，各種電氣功能以及數據處理都要根據邏輯位的狀態發生改變。一組邏輯位組成的「內存行」可以表示很多可能，比如一組8位的字節可以表示256種狀態。不在對應內存行的數據或者超出有效狀態的數值均為無效內容。錯誤管理內存行會導致「程序跑飛」，程序跑飛時必須緊急停機，否則會導致系統結構解體。 Windows電腦突然呈現的「藍屏」（常見Windows版本）或者「綠屏」（測試版Windows，WIP），就是一種緊急停機的表現。

報文可能出現的格式
報文類型	原始數據	解析結果
空報文	`0xC0,`	END_COLLECTION
1位元組報文	`0x05, 0x01,`	USAGE_PAGE(Generic Desktop)
2位元組報文	`0x26, 0x7F, 0xFF,`	LOGICAL_MAXIMUM(32767)
4位元組報文	`0x0B, 0x20, 0x00, 0xD0, 0xF1,`	USAGE(0xF1D0:FIDO_Alliance, 0x0020:Input_Report_Data)

原始數據對應釋義
原始數據	報頭分類（翻譯）¹	報文長度	注意事項
0x00	MAIN/基礎功能	0位元組	放置在不同位置的原始數據會出現不同釋義，如「0x01」放在「報頭分類」區域會編譯為「GLOBAL類項目」，「0x01」放在「報文長度」會表示「1位元組報文」。「短項目」報頭聲明會受到「報頭分類」的影響而受到不同制約。若報頭分類為0x03時，請使用長項目數據格式，不能繼續使用「短項目」數據格式。
0x01	GLOBAL/廣義聲明	1位元組
0x02	LOCAL/狹義聲明	2位元組
0x03	LONG/長項目修飾符²	3位元組

報頭類型與編碼
（**{{Ptl}}模板已棄用。**為0xF0）
原始數據	報頭名稱	使用方法
MAIN / 基礎功能控制HID解析器執行報表製成或分組
0x80	INPUT 打包數據入表	3個報頭的報文大小均為1/2位元組報文，組合內存行。前述兩個報頭均為必需報頭，一個數據報表格式描述符需要至少一個這樣的報文，且三種報頭至少需要其一。報表打包：根據修飾屬性和註冊的用途清單，創建對應內存行/寄存器。數據輸入：將設備報告已觸發的{{Ptl}}模板已棄用。上傳至主機。必須有一個{{Ptl}}模板已棄用。以傳輸實時變化的數據報表。數據輸出：將主機報告已觸發的事件下載至設備。可分配一個{{Ptl}}模板已棄用。以傳輸實時變化的數據報表，否則只通過{{Ptl}}模板已棄用。的{{Ptl}}模板已棄用。傳輸數據報表。設備特性：在主機與設備的傳輸中交換設備特性，只能通過控制端點交換數據。如果需要定義為{{Ptl}}模板已棄用。，必須使用2位元組報文。對應操作結束後會清空狹義聲明。
0x90	OUTPUT 打包數據出表
0xB0	FEATURE 打包設備特性表
0xA0	COLLECTION 集合起始域	COLLECTION報頭為1位元組報文，無符號整數，END_COLLECTION報頭為無數據報頭。前述兩個報頭均為必需報頭，一個數據報表格式描述符需要至少一組這樣成對的報文。集合或分組：創建報文分組，提高HID解析器和電腦軟體的解析效率。一個數據報表格式描述符需要至少一個最高級{{Ptl}}模板已棄用。集合。同時具備多個HID標準類型的單個設備視作「多個應用領域」。如果開發的1個{{Ptl}}模板已棄用。只有一個應用領域，可以不再對數據報表格式描述符進行分組。 COLLECTION報頭和END_COLLECTION報頭必須成對出現，但是允許嵌套。
0xC0	END_COLLECTION 集合結束域
基礎功能所生成的項目會受到廣義聲明和狹義聲明的調整。
GLOBAL / 廣義聲明修飾一個數據報表的擴展屬性
0x00	USAGE_PAGE 定位用途類別	1位元組報文，部分用途類別需要2位元組；不論字節大小均為無符號整數。可選報頭¹，根據USAGE報頭決定是否為必需報頭²。用途註冊：向HID解析器添加可能會用到的用途。其中此報頭用於定位用途所在的類別表格編號。此報頭可節省用途聲明所需的代碼，比如註冊同一類別表格下的零散用途。對於工作在低速模式下的設備而言，由於控制端點字長為恆定8位元組，此報頭為必需報頭。如果數據報表格式描述符集合中，第一個USAGE_PAGE前面有USAGE報頭，HID解析器會將集合起始域後的第一個USAGE中的低16位元組用作USAGE_PAGE.
0x10	LOGICAL_MINIMUM 數字域最小值	4個報頭的報文大小可使用1/2/4位元組的報文，並且均為{{Ptl}}模板已棄用。。「數字域」相關報頭均為必需報頭¹，一個數據報表格式描述符需要至少一個對應類別的報文²；「實體域」報頭為可選報頭³。數據極值：劃定有效數據的最大值/最小值範圍。「實體域數值」指的是設備在實際應用中對應的有效數據；「數字域數值」指的是數位訊號傳輸過程中對應的等效數值；「極值」包含「最大值」和「最小值」。未聲明極值時，對應的極值將取預設值「0x00」；「數字域最大值」不能小於或等於「數字域最小值」。極值以外的數值均視作{{Ptl}}模板已棄用。；「-2147483648（0x8000 0000）」為恆定NULL值，禁止用作極值。「實體域」極值不被用作數據報表創建，僅供應用程式讀取相關內容以修改算法，比如「電子減速器」。
0x20	LOGICAL_MAXIMUM 數字域最大值
0x30	PHYSICAL_MINIMUM 實體域最小值
0x40	PHYSICAL_MAXIMUM 實體域最大值
0x50	UNIT_EXPONENT 實體域10乘倍數	「UNIT_EXPONENT」僅使用1位元組的低4位¹，「UNIT」為7組4位（組合內存），並且均為有符號整數。前述兩個報頭均為可選報頭²。實體域單位聲明：聲明數據對應的單位與10乘倍數。 “10乘倍數”算式效果為$1×10^x$。「UNIT」報頭的數據結構很複雜，第0位元組的低4位表示單位所使用的度量制（公制/英制）與坐標體系（直角坐標/極坐標），其餘分組的4位內存表示各單位的{{Ptl}}模板已棄用。，對應單位會隨著度量制的不同而發生改變。該字節高4位沒有任何意義，恆定為0x0. 不被用作數據報表創建，僅供應用程式讀取相關內容以修改算法。
0x60	UNIT 實體域單位與導數
0x80	REPORT_ID 數據報表編號	1位元組報文，無符號整數。「0x00」為NULL值。多重數據報表：聲明對應報表所處的編號。同時只能傳輸一整個數據報表，需要傳輸的報表編號可被設備輪換或主機控制。
0x70	REPORT_SIZE 項目佔用大小	前述兩個報頭均為1位元組無符號整數，「0x00」為NULL值。前述兩個報頭均為必需報頭，一個數據報表格式描述符需要至少一個對應類別的報文。數據格式：聲明單次註冊（數據打包）所需要的項目數量與單個項目的佔用大小。「REPORT_SIZE」的單位不是1個字節而是1個邏輯位。「REPORT_COUNT」的單位為數量。被註冊的內存將使用「REPORT_SIZE」×「REPORT_COUNT」個邏輯位，但打包成數據傳輸時，剩餘不滿1個字節的部分需要根據以下情形填充為整個字節：如果在報表打包過程中聲明瞭「BUFFERED_BYTES」，不需要填充字節，但此情形僅用於一個特殊事件（項目），這種特殊項目佔用的位大小為字節的整數倍。剩餘未使用的邏輯位以1個「無意義項目」的形式打包成聲明「CONSTANT」的數據。單個項目佔用的數據長度上限為32個邏輯位。
0x90	REPORT_COUNT 打包所需項目個數
0xA0	PUSH 廣義聲明存檔	前述兩個報頭均為無數據報頭。前述兩個報頭均為可選報頭。廣義聲明緩存區：用於快速複製廣義聲明修飾的屬性緩存區只有一倍大小的空間，使用範圍不受「COLLECTION」類報頭影響，全局有效。連續使用PUSH會替換舊內存，不論多少次使用POP都只會讀取當次POP前最後一次PUSH的內存。
0xB0	POP 廣義聲明讀檔
一個廣義聲明報頭的影響範圍會從本身開始，截至下一個同類廣義聲明。{{Ptl}}模板已棄用。
LOCAL / 狹義聲明具有限定範圍的屬性修飾符
一個狹義聲明報頭經過聲明後，其影響範圍會從本身開始截至下一個「MAIN」類報頭，多個狹義聲明報頭共存且互不幹擾。

必需文檔連結

綜述

數據報表格式

序言

報頭格式

報頭類別

報頭用法

數據組態

應用例

標準USB鍵盤