|
|
围绕「HID Usage Page 怎么定：通用桌面页、键盘页与消费者页的编号边界」，先把边界讲清楚，再谈结论。本页属于 HID 协议报文与描述符字节级解析专题，讨论的是Usage Page 与 Usage，重点是报文落到字节层面之后才出现的解释问题，而不是设备怎么选、链路怎么连或者效能怎么算。文中出现的每一个阈值都给出测量口径与适用边界；HID Usage Page、HID通用桌面页、HID位域解析 等说法会在具体段落里落到可核对的字段与动作上，读者可以直接照着做一份按帧序号可检索的标注稿。本篇是第 2 簇的第 1 个角度，与同簇其余五篇互为补充，与站内其他专题则各自负责不同环节，不重复叙述。
一、Usage Page 与 Usage：先把定义与边界钉死
把字段定义与位边界单独拿出来讲，是因为它最容易被跳过。描述符看懂了、帧也抓了，但缺了这一步，前面攒下的标注稿在出问题时对不上号。
数据的可比性来自口径一致，而不是来自帧多。同一个通用桌面页指标，若甲组按首帧起算、乙组按首个有效字段起算，两组数字放在一起只会制造争议。我们把每个指标都写成四段式定义：偏移、取位、剔除、归档，并配一条示例帧。新成员照着示例解一遍，得到的格式就与历史标注对齐，后续做跨批次、跨设备的对照才成立。
就定义而言，Usage Page指的是Usage Page 给出大类，Usage 给出大类，而不是泛泛的「配置好了」。本站统一把前者作为可登记的字段，把后者只当作口头描述，二者在记录里不可互换。
二、Usage Page 与 Usage：按字节顺序逐项拆解
先把字节边界划清楚。本篇只看Usage Page 与 Usage这一段，不延伸到设备选型、脚本写法或收益核算；本站其他专题各有归属，混在一起讲反而让字段解释失去基准。
混合设备的难点是长尾，不是均值。同一端点上有固定帧长的引导报表，也有变长的自定义报表，若按平均帧长设定缓冲，解析总会卡在同一批最慢帧上。因此混编组的节拍基准取最长帧，统计同时给出中位、九十五分位与九十九分位三个数值。新旧描述符的字段差异由分流表收敛，业务侧不写分支；按报表 ID 分批，能显著减小时间对齐误差。
Usage Page 一旦设定会一直生效，直到下一个 Usage Page 项出现，因此跨段解析时不能只看紧邻的一行。
命名与编号看似琐碎，却决定了后面所有标注能不能被检索。建议采用日期、批次、设备、报表 ID 四段式，段间用固定分隔符，任何一段都不允许省略或用「临时」代替。帧编号一经分配不再回收复用，废弃编号进入保留区，这样历史结论永远指向当初那一帧，不会因为后来补进一段抓包而错指。重新标注必须留痕，写明原因、时间与操作人。
建议把本段的偏移量抄进现场卡片，复核时逐条念，避免不同批次用了不同的字段起点。
三、Usage Page 与 Usage：十六进制实例与数值对照
需要提醒的是，以下数值来自可控环境下的重复抓包，用于建立比较基准，不代表任何一批设备的绝对上限；换型号、换协议状态之后应当重测。
最后强调可回溯性：任何一次判定都要能回答「依据是哪一帧」。因此原始 hex、标注稿、复核结论三者必须互相指得上去，文件名包含日期与批次，目录结构固定不变。历史版本只读，不做覆盖式修改；确需更正时新增一条修订记录并注明原因。做到这一点之后，即便人员换了几轮，后来者也能独立复现当时的结论，而不是只能接受一句口头交代。
同一数值在不同页下含义完全不同，脱离页面编号单独解释 Usage 是抓包分析里最常见的错误。
下表按同一口径整理，数值来自 13 帧原始报文、连续 3 个采集周期的重复抓包，仅用于建立比较基准；换型号或换协议状态之后应当重新测一遍并更新表格。
我们把字段定义与位边界拆成六个可交付的动作：截取、定标、拆位、对照、复核、归档。截取要求把参与本轮的所有帧列全并标注来源；定标要明确位宽与字节序；拆位阶段禁止临时改掩码；对照必须由不同于拆位的人完成；复核要求产出可检索标注稿；归档在下一个采集周期再做一次核验。六步之间不留跳步空间，跳过的那一步往往正是后来出问题的地方。
把这一段的判定写进复核表，下次执行时按表打勾，比依赖当事人记忆稳得多。
- 字段对照表（Usage Page 与 Usage · 字段定义与位边界）
- 页号宽度：1 字节常用（按前缀定）
- 页作用范围：持续生效（直到改页）
- Usage 宽度：1 / 2 字节（看前缀）
- 对照表分组：按页（避免串义）
- 解析输出：hex + 名称（便于人工复核）
- 版本标注：必备（规范会增补）
四、Usage Page 与 Usage：容易误读的边界与陷阱
这一段只回答一个具体问题：在字段定义与位边界视角下，Usage Page 与 Usage应当按什么字节顺序读，哪些解释算成立，哪些必须打回重做。
站点内其他专题分别讨论设备怎么选、链路怎么连、效能怎么算、工位怎么搭。Usage Page 与 Usage与它们是互补关系，不构成替代：这里给出的每一项偏移都假设设备已枚举成功、端点已可用，专注解决字节层面才出现的解释问题。读者若需要前序环节的背景，可从页脚的全站入口进入对应专题，两处的口径不冲突，也不重复叙述。
对照表建议按页分组保存，解析结果里同时输出十六进制值与中文名称两列，人工复核效率最高。
标注要能串起来才有价值。一次解析贯穿截取、拆位、对照三段，三段记录必须共用同一个帧编号；缺了编号，就只能靠时间戳猜测关联，而各采集口本地时钟相差几秒是常态。因此统一时钟源是前置条件，字段至少包含帧序号、采集时刻、设备标识、报表 ID、规则版本、结论六项。正常时段可降采样节省空间，异常时段强制全量保留，关键证据不能为了省容量被丢掉。
归档时把原始 hex、标注稿与判定结论放在同一目录，历史版本只读不覆盖。
六步逐字节拆解流程
- 截取本轮参与的全部原始帧，标注采集时刻与设备标识，缺来源的帧先补登记，不直接进入拆位。
- 按Usage Page确定位宽与字节序，把取位规则写进标注稿首页，避免不同批次各解各的。
- 取一次规则变更前快照，内容覆盖描述符、端点参数、分流表与解析脚本四层，文件按时间戳命名只读保存。
- 按单变量原则逐字节拆位，过程中不临时改掩码；确需调整时另起一轮并重新取快照。
- 由非拆位人做对照，覆盖Usage与相邻报表 ID，输出通过或不通过两档结论。
- 把原始 hex、标注稿与复核结论归入同一目录，验收通过的规则版本写入对照库并安排月度抽查。
五、Usage Page 与 Usage：压测记录与数据解读
这一段偏重可操作性。所有步骤都按「谁读、读哪几个字节、留下什么证据」三栏描述，缺任意一栏的环节在复核时会被标为待补。
字段之间不是独立的。调整Usage Page时，键盘页的位边界会跟着变化，若只盯单个字段，容易把整帧推到一个各项都「刚好对齐」却毫无缓冲的状态。做法是给每个关键字段配一张联动检查表：改一处，表里其余三处同步复算，任何一处跌出字节边界就整体回退。实测这种联动复算能把返工次数压到原来的三分之一左右，成本只是多花几分钟填表。
本轮对照从 13 帧起步，每档增加 5 帧，每档保持一个完整采集周期，记录帧率、待解队列与偏移分布三项。曲线在三档之后开始出现明显拐点，据此把分流阈值定在拐点之前，而不是等队列触顶再处理。
0x01 是通用桌面页，0x07 是键盘与键盘数组页，0x0C 是消费者控制页，编号含义由规范统一约定。
最后强调可回溯性：任何一次判定都要能回答「依据是哪一帧」。因此原始 hex、标注稿、复核结论三者必须互相指得上去，文件名包含日期与批次，目录结构固定不变。历史版本只读，不做覆盖式修改；确需更正时新增一条修订记录并注明原因。做到这一点之后，即便人员换了几轮，后来者也能独立复现当时的结论，而不是只能接受一句口头交代。
这类记录积累三五轮之后，就能看出趋势：是稳定收敛，还是每次都在同一个字节位置反复出问题。
六、Usage Page 与 Usage：检查清单与复盘归档
先说结论：Usage Page 与 Usage没有一劳永逸的偏移，只有可核对的拆解过程。下面把过程拆成可检查的动作，并给出每个动作的判定依据。
隔离验证的做法是主动制造一次可控的局部异常：选定一个报表 ID，向其中注入一串已知帧，同时在相邻 ID 的通道抓包记录。合格判定是相邻通道零条串入、本通道回执完整、其余解析流程无感知。演练要覆盖自动与手动两条路径，因为自动分流存在误判可能，现场人员必须有一条不依赖系统的兜底操作。演练结论与影响帧数一起归档，作为下轮切分依据。
Usage Page 一旦设定会一直生效，直到下一个 Usage Page 项出现，因此跨段解析时不能只看紧邻的一行。
取位方法比解释值本身更重要。针对Usage，我们采用固定窗口加全量留痕：窗口长度按一个完整采集周期设定，窗口内的每一帧都写入记录，不做抽样省略。统计时先做时间对齐，再按25帧粒度聚合，最后把异常帧单独归集。剔除规则必须写在标注稿首页，例如计划内重启、控制传输状态阶段、空轮询三类帧不计入分母，避免不同批次算出互不可比的结果。
以上四项若有一项缺失，本轮标注标记为待补，不进入对照库，也不作为后续比较的分母。
复核检查清单
- 每条 Usage 都带所属页号
- 页号变更处已单独标注
- 对照表版本已写明
- 同值跨页用例已跑过
- 中文名称与规范一致
- 标注稿可检索
收束一下：Usage Page 与 Usage 的核心不是背下几个十六进制常数，而是让每次解析都留下可核对的字节链条。定义、取位、快照、对照、归档五件事齐了，报表格式从固定八字节换到自定义多路复用时，问题才不会变成一笔糊涂账。本篇给出的方法可以直接嵌进现场已有的抓包流程；若需要了解设备形态、接入拓扑、效能核算或工位搭配，可从页脚的全站入口进入对应专题，各页角度互不替代。
相关字节记录（更多 HID 报文字节解析）
1. HID 报表描述符怎么读：前缀字节、项标签与数据长度的拆分规则
返回 HID 报文字节首页 · HID 产品·选购 · HID 技术·方案 · HID 实战·副业 · HID 百科 · HID 评测 · HID 安全·合规 · HID 行业情报 · HID 工位生态 · HID 效能账本 · HID 接入拓扑
|
|
发表于 
发表于