HID 负方向读成大正数，怎样按逻辑范围解析有符号字段

HID轴向负值被读成255、4095等大正数，先检查Report Descriptor中的逻辑范围与字段位宽。Logical Minimum为负时，相关整数按二补数解释，需要对字段实际位宽做符号扩展；不能把所有报告字节一律读成无符号，也不能先扩到16位再按错误符号位判断。

环境和证据范围

只处理已按报告描述符提取出的整数位域，不自动猜USB设备协议。附件中的8位和12位字段均为合成，逻辑范围明确为有符号；没有抓取真实HID报告。字段类型、Usage、单位与物理范围仍需从对应描述符和设备文档读取。

核对顺序

1. 先保存设备VID/PID、接口号、报告描述符和原始report。定位目标Usage的Report Size、Report Count及Logical Minimum/Maximum，确认读的是目标轴，不是Report ID或按钮位。

2. 在提取n位原始值后，若采用有符号解释且最高位为1，减去2^n；否则保留原值。这个步骤作用于字段自身，不作用于含填充位的整个字节数组。

3. 使用正边界、负一和最小负值检查符号位。8位0xff应为-1，0x80为-128；12位0xfff为-1，0x800为-2048；无符号字段0xff仍应是255。

4. 符号解析后再检查逻辑范围与单位缩放，不能把超范围编码自动夹进端点。若驱动API已经返回有符号缩放值，不应再次手工符号扩展，否则会二次变换。

可复算的输入与预期

附件五条预期为-1、-128、-1、-2048和255，另有8位0x7f为127。脚本先确认原值确实落在0到2^n-1，再按声明的signed分支计算；这验证的是字段算术，不代表整个USB报告解析已经通过。

逻辑范围还可以小于整个位宽能够表示的范围。8位有符号字段能编码-128到127，但某设备可能只声明-100到100；符号扩展后仍须按声明范围检查，不能因为字节能解成整数就认定是有效轴值。

下载与现场记录

下载本题合成输入与预期JSON、离线只读核验脚本和现场空白记录CSV。放在同一目录，用 Python 3 运行 python verify.py，逐项计算或解析后与预期比较，失败会显示差异。

现场字段包括 vid_pid、usage、report_size、logical_minimum、logical_maximum、raw_field_hex、signed_value。合成样例保持原样，实测另存并填写型号、版本、证据路径，未采集处留空。本地核验不代表真实设备、代理、浏览器或长期稳定性已测。

失败分支与移交

把12位字段装进16位后直接读取int16，0x0fff会仍是4095，正是符号位位置错了。另一种错误是看数值“大”就减65536，会把合法无符号轴损坏。若左移和掩码处理不清楚，先输出字段位串与位宽，逐个对照描述符。

移交应附描述符原始字节、目标Usage定位、逻辑范围、位宽、解析前后值和驱动API名称。现场还需让装置向正负方向各移动一次，验证设备实际报告语义；本文不触发机构，不宣称已校验任何触摸框、手柄或旋钮的方向。

基础背景可看互动投影感应方案对比（雷达/红外/摄像头/深度）。字段提取位置有误时，符号计算也无意义，先核对HID 报告多了一个字节，怎样核对 Report ID 与位偏移。更多资料在触摸互动技术方案。

需要项目联调时，可按上述字段整理资料，联系企服君核对实际接入范围。

一级资料

• 官方资料：§6.2.2.7 Global Items，逻辑最小值与二补数

核对日期：2026-10-24。规范定义与本文应用约定分开，示例门限及脚本不自动代表产品原生能力。