找回密码
 立即注册
搜索
热搜: 活动 交友 discuz
查看: 3|回复: 0

[HIDL] HID Usage 常见误读:脱离页面解释、跨段沿用旧页与编号混用

[复制链接]

892

主题

1263

回帖

5885

积分

abc

积分
5885
发表于 24 分钟前 | 显示全部楼层 |阅读模式
围绕「HID Usage 常见误读:脱离页面解释、跨段沿用旧页与编号混用」,先把边界讲清楚,再谈结论。本页属于 HID 协议报文与描述符字节级解析专题,讨论的是Usage Page 与 Usage,重点是报文落到字节层面之后才出现的解释问题,而不是设备怎么选、链路怎么连或者效能怎么算。文中出现的每一个阈值都给出测量口径与适用边界;HID键盘页、HID编号对照表、HID抓包分析 等说法会在具体段落里落到可核对的字段与动作上,读者可以直接照着做一份按帧序号可检索的标注稿。本篇是第 2 簇的第 4 个角度,与同簇其余五篇互为补充,与站内其他专题则各自负责不同环节,不重复叙述。


一、Usage Page 与 Usage:先把定义与边界钉死

这一段只回答一个具体问题:在常见误读与越界视角下,Usage Page 与 Usage应当按什么字节顺序读,哪些解释算成立,哪些必须打回重做。

最后强调可回溯性:任何一次判定都要能回答「依据是哪一帧」。因此原始 hex、标注稿、复核结论三者必须互相指得上去,文件名包含日期与批次,目录结构固定不变。历史版本只读,不做覆盖式修改;确需更正时新增一条修订记录并注明原因。做到这一点之后,即便人员换了几轮,后来者也能独立复现当时的结论,而不是只能接受一句口头交代。

就定义而言,键盘页指的是Usage Page 给出大类,Usage 给出大类,而不是泛泛的「配置好了」。本站统一把前者作为可登记的字段,把后者只当作口头描述,二者在记录里不可互换。





二、Usage Page 与 Usage:按字节顺序逐项拆解

这一段偏重可操作性。所有步骤都按「谁读、读哪几个字节、留下什么证据」三栏描述,缺任意一栏的环节在复核时会被标为待补。

站点内其他专题分别讨论设备怎么选、链路怎么连、效能怎么算、工位怎么搭。Usage Page 与 Usage与它们是互补关系,不构成替代:这里给出的每一项偏移都假设设备已枚举成功、端点已可用,专注解决字节层面才出现的解释问题。读者若需要前序环节的背景,可从页脚的全站入口进入对应专题,两处的口径不冲突,也不重复叙述。

0x01 是通用桌面页,0x07 是键盘与键盘数组页,0x0C 是消费者控制页,编号含义由规范统一约定。

混合设备的难点是长尾,不是均值。同一端点上有固定帧长的引导报表,也有变长的自定义报表,若按平均帧长设定缓冲,解析总会卡在同一批最慢帧上。因此混编组的节拍基准取最长帧,统计同时给出中位、九十五分位与九十九分位三个数值。新旧描述符的字段差异由分流表收敛,业务侧不写分支;按报表 ID 分批,能显著减小时间对齐误差。

到这里为止,Usage Page 与 Usage在常见误读与越界视角下的位边界、拆解动作与证据都已明确,下一段接着看它在异常输入下会不会变形。


三、Usage Page 与 Usage:十六进制实例与数值对照

先说结论:Usage Page 与 Usage没有一劳永逸的偏移,只有可核对的拆解过程。下面把过程拆成可检查的动作,并给出每个动作的判定依据。

字段之间不是独立的。调整消费者页时,Usage的位边界会跟着变化,若只盯单个字段,容易把整帧推到一个各项都「刚好对齐」却毫无缓冲的状态。做法是给每个关键字段配一张联动检查表:改一处,表里其余三处同步复算,任何一处跌出字节边界就整体回退。实测这种联动复算能把返工次数压到原来的三分之一左右,成本只是多花几分钟填表。

Usage Page 一旦设定会一直生效,直到下一个 Usage Page 项出现,因此跨段解析时不能只看紧邻的一行。

下表按同一口径整理,数值来自 22 帧原始报文、连续 6 个采集周期的重复抓包,仅用于建立比较基准;换型号或换协议状态之后应当重新测一遍并更新表格。

命名与编号看似琐碎,却决定了后面所有标注能不能被检索。建议采用日期、批次、设备、报表 ID 四段式,段间用固定分隔符,任何一段都不允许省略或用「临时」代替。帧编号一经分配不再回收复用,废弃编号进入保留区,这样历史结论永远指向当初那一帧,不会因为后来补进一段抓包而错指。重新标注必须留痕,写明原因、时间与操作人。

若现场条件不允许一次做到位,优先保证原始帧完整,解释精度可以分阶段补齐,顺序不要反过来。


  • 字段对照表(Usage Page 与 Usage · 常见误读与越界)
  • 页号宽度:1 字节常用(按前缀定)
  • 页作用范围:持续生效(直到改页)
  • Usage 宽度:1 / 2 字节(看前缀)
  • 对照表分组:按页(避免串义)
  • 解析输出:hex + 名称(便于人工复核)
  • 版本标注:必备(规范会增补)



四、Usage Page 与 Usage:容易误读的边界与陷阱

下面这段把常见误读与越界放进完整链路里看,而不是孤立地评估它。从描述符到数据帧的偏差常常在两段之间的缝隙里累积,单点都合格不代表整段合格。

隔离验证的做法是主动制造一次可控的局部异常:选定一个报表 ID,向其中注入一串已知帧,同时在相邻 ID 的通道抓包记录。合格判定是相邻通道零条串入、本通道回执完整、其余解析流程无感知。演练要覆盖自动与手动两条路径,因为自动分流存在误判可能,现场人员必须有一条不依赖系统的兜底操作。演练结论与影响帧数一起归档,作为下轮切分依据。

同一数值在不同页下含义完全不同,脱离页面编号单独解释 Usage 是抓包分析里最常见的错误。

我们把常见误读与越界拆成六个可交付的动作:截取、定标、拆位、对照、复核、归档。截取要求把参与本轮的所有帧列全并标注来源;定标要明确位宽与字节序;拆位阶段禁止临时改掩码;对照必须由不同于拆位的人完成;复核要求产出可检索标注稿;归档在下一个采集周期再做一次核验。六步之间不留跳步空间,跳过的那一步往往正是后来出问题的地方。

这一层做完应当产出一份按帧序号可检索的标注稿,而不只是一句「已解析」;可检索是复核的最低要求。


六步逐字节拆解流程


  • 截取本轮参与的全部原始帧,标注采集时刻与设备标识,缺来源的帧先补登记,不直接进入拆位。
  • 按Usage Page确定位宽与字节序,把取位规则写进标注稿首页,避免不同批次各解各的。
  • 取一次规则变更前快照,内容覆盖描述符、端点参数、分流表与解析脚本四层,文件按时间戳命名只读保存。
  • 按单变量原则逐字节拆位,过程中不临时改掩码;确需调整时另起一轮并重新取快照。
  • 由非拆位人做对照,覆盖Usage与相邻报表 ID,输出通过或不通过两档结论。
  • 把原始 hex、标注稿与复核结论归入同一目录,验收通过的规则版本写入对照库并安排月度抽查。



五、Usage Page 与 Usage:压测记录与数据解读

这里采用字节级记录的写法:先给字段定义,再给取位方法,然后给判定阈值,最后给归档格式。读者照着做,得到的标注表应当与本文示例一致。

关于Usage Page与键盘页的联动,还有一条经验:不要在同一轮里同时改两项。两项一起变,出问题时无法判断是哪一项引起的,只能整体回滚,前面所有抓包数据作废。单变量推进看起来慢,实际总耗时更短,因为每一轮都能得到确定结论。变更记录里应写明本轮只动了哪一处、预期字段变化是什么、实际观察是否一致,三行字省下的是后面半天的排查。

本轮对照从 22 帧起步,每档增加 5 帧,每档保持一个完整采集周期,记录帧率、待解队列与偏移分布三项。曲线在三档之后开始出现明显拐点,据此把分流阈值定在拐点之前,而不是等队列触顶再处理。

对照表建议按页分组保存,解析结果里同时输出十六进制值与中文名称两列,人工复核效率最高。

标注要能串起来才有价值。一次解析贯穿截取、拆位、对照三段,三段记录必须共用同一个帧编号;缺了编号,就只能靠时间戳猜测关联,而各采集口本地时钟相差几秒是常态。因此统一时钟源是前置条件,字段至少包含帧序号、采集时刻、设备标识、报表 ID、规则版本、结论六项。正常时段可降采样节省空间,异常时段强制全量保留,关键证据不能为了省容量被丢掉。

建议把本段的偏移量抄进现场卡片,复核时逐条念,避免不同批次用了不同的字段起点。





六、Usage Page 与 Usage:检查清单与复盘归档

从原始 hex 出发比从概念出发可靠。过去若干次Usage Page 与 Usage的整理里,真正导致返工的往往不是原理没懂,而是某个偏移没登记、某次修订没留痕。

命名与编号看似琐碎,却决定了后面所有标注能不能被检索。建议采用日期、批次、设备、报表 ID 四段式,段间用固定分隔符,任何一段都不允许省略或用「临时」代替。帧编号一经分配不再回收复用,废弃编号进入保留区,这样历史结论永远指向当初那一帧,不会因为后来补进一段抓包而错指。重新标注必须留痕,写明原因、时间与操作人。

0x01 是通用桌面页,0x07 是键盘与键盘数组页,0x0C 是消费者控制页,编号含义由规范统一约定。

最后强调可回溯性:任何一次判定都要能回答「依据是哪一帧」。因此原始 hex、标注稿、复核结论三者必须互相指得上去,文件名包含日期与批次,目录结构固定不变。历史版本只读,不做覆盖式修改;确需更正时新增一条修订记录并注明原因。做到这一点之后,即便人员换了几轮,后来者也能独立复现当时的结论,而不是只能接受一句口头交代。

把这一段的判定写进复核表,下次执行时按表打勾,比依赖当事人记忆稳得多。


复核检查清单


  • 每条 Usage 都带所属页号
  • 页号变更处已单独标注
  • 对照表版本已写明
  • 同值跨页用例已跑过
  • 中文名称与规范一致
  • 标注稿可检索


收束一下:Usage Page 与 Usage 的核心不是背下几个十六进制常数,而是让每次解析都留下可核对的字节链条。定义、取位、快照、对照、归档五件事齐了,报表格式从固定八字节换到自定义多路复用时,问题才不会变成一笔糊涂账。本篇给出的方法可以直接嵌进现场已有的抓包流程;若需要了解设备形态、接入拓扑、效能核算或工位搭配,可从页脚的全站入口进入对应专题,各页角度互不替代。

相关字节记录(更多 HID 报文字节解析)
1. HID 帧校验对照表:偏移、原始字节与解释值的三列实例
2. HID 类请求怎么解:Get_Report 与 Set_Report 的字段拆分
3. HID 全局项逐字节拆解六步:取值、更新、快照、复核、对照、归档

返回 HID 报文字节首页 · HID 产品·选购 · HID 技术·方案 · HID 实战·副业 · HID 百科 · HID 评测 · HID 安全·合规 · HID 行业情报 · HID 工位生态 · HID 效能账本 · HID 接入拓扑
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver|手机版|小黑屋|

GMT+8, 2026-11-23 03:48

安卓脚本软件 · 键鼠盒子 · HID · 机械臂

快速回复 返回顶部 返回列表

随机推荐 · 热帖 / 新帖 / 随便看看

社区会员(随机展示)