I2C HID从零实现：USB类比通信的操作指南

以下是对您提供的博文内容进行深度润色与重构后的技术文章。整体风格更贴近一位资深嵌入式工程师在技术社区中自然、扎实、有温度的分享——去AI感、强实操性、逻辑层层递进、语言精炼有力，同时完全保留所有关键技术细节、代码示例和工程洞见，并显著增强可读性、教学性与传播力。

用I²C“假装”是个USB键盘：一个嵌入式工程师的轻量级HID实践手记

“我们不是在做USB，而是在让主机相信——它连上的就是个标准USB设备。”

这是我在给一款医疗手持终端加按键交互功能时的真实顿悟。当时主控是颗资源极紧的STM32G030F6（32KB Flash / 8KB RAM），团队已否决了USB方案：PHY成本高、布线难、驱动调试周期长，且Windows上偶发枚举失败——而客户只想要“插上就能用”的体验。

后来我翻出尘封已久的《I²C HID Specification v1.0》，试了三天，把一个8键矩阵键盘通过I²C“骗过”了Windows和Linux——没有驱动、没有libusb、不改内核，只靠63字节描述符 + 7个寄存器 + 一段不到200行的裸机I²C从机代码。

这篇文章，就是我把这段经历拆解成可复现、可裁剪、可debug的完整路径。不讲空泛概念，只说你真正会卡住的地方：寄存器怎么填？描述符为什么总被内核reject？轮询间隔改了却没生效？报告更新时为啥老读到旧值？

它为什么能“冒充”USB设备？

先破除一个迷思：I²C HID不是USB over I²C，也不是协议转换桥。它压根不碰USB协议栈，也不需要D+ D−信号线。

它的本质，是一种语义映射协议——操作系统看到的，依然是标准的HID设备；但背后的数据通道，换成了最朴素的I²C读写。

Windows/Linux/macOS的HID子系统早已内置支持：
- Linux：drivers/hid/i2c-hid/（自4.15起默认启用）
- Windows：i2c_hid.sys（Win10 1809+）
- macOS：AppleI2CHID（macOS 12 Monterey起）

它们的工作方式高度统一：
✅ 扫描I²C总线，发现新从机
✅ 读寄存器0x00–0x01→ 得到描述符内存地址
✅ 读寄存器0x02→ 得到描述符长度
✅ 按地址+长度，批量读取二进制描述符
✅ 解析后，自动绑定hid-generic或hid-input驱动
✅ 后续所有输入数据，都从寄存器0x03开始读

整个过程，MCU只需要响应I²C地址匹配、寄存器地址接收、数据发送——不需要中断嵌套、不需要状态机、甚至不需要理解“HID”这个词。

这才是它能在M0+/RISC-V小核上跑起来的根本原因：
🔹 ROM开销 < 3.2 KB（含I²C外设驱动 + 描述符 + 报告组装）
🔹 RAM占用 < 1.8 KB（双缓冲+描述符缓存）
🔹 最高仅依赖标准I²C从机模式（无DMA也OK）

寄存器不是摆设：7个地址，决定你能不能被识别

I²C HID规范定义了8个强制寄存器（0x00 ~ 0x07），但实际能让你设备“活下来”的，核心就这5个：