第7讲:HID 设备——做一个键盘或鼠标

发布时间:2026/10/29 11:00:26
第7讲:HID 设备——做一个键盘或鼠标 本讲目标理解 HID 为什么通常可以使用系统通用驱动认识 Report Descriptor并了解键盘和鼠标的基本报告格式。一、HID 为什么通常不需要专用驱动HID 的全称是 Human Interface Device即人机接口设备。常见的 HID 设备包括键盘、鼠标和许多游戏手柄。HID 规范不仅定义了接口类别还定义了设备如何描述自己的报告格式以及如何通过 Input、Output 和 Feature Report 等机制交换数据。操作系统提供通用 HID 驱动因此符合规范的设备通常不需要为每个产品单独编写底层驱动。但要注意把接口类代码写成 HID 并不代表设备就一定能正常工作。报告描述符和实际报告数据必须匹配。二、Report Descriptor 是什么可以把 Report Descriptor 理解成一份数据格式说明书。它告诉 Host报告中有哪些字段。每个字段占多少位。字段有多少个。字段的逻辑取值范围。字段代表什么用途。而真正运行时发送的数据叫作报告例如 Input Report。因此Report Descriptor 描述格式Input Report 承载实际状态。两者不能混为一谈。三、键盘报告是怎样的一种常见的 Boot Keyboard 输入报告长度为 8 字节字节常见用途Byte 0Ctrl、Shift、Alt 等修饰键状态Byte 1保留字段Byte 27最多列出 6 个普通按键的 Usage ID这只是常见 Boot Keyboard 格式不代表所有 HID 键盘都必须采用同一种报告布局。例如按下字母 A 时设备上报的是对应的 HID Usage而不是直接发送 ASCII 字符A。最终显示什么字符还与操作系统键盘布局、修饰键状态以及输入法有关。一个简单的按键过程假设要实现按下 A 键可以采用下面的逻辑发送 A 键按下报告 | 电脑识别到按键状态 | 发送所有按键释放报告如果一直没有发送释放状态电脑就可能认为按键仍然处于按下状态。实际报告字节必须根据使用的 Report Descriptor 及其 Usage 定义确定不能脱离描述符直接套用示例数据。四、鼠标报告相对移动与绝对定位常见鼠标报告包含按钮状态以及 X、Y 位移。例如Buttons 0 X 5 Y -2如果报告描述符定义的是相对坐标那么它表示鼠标相对移动了相应单位而不是移动到屏幕坐标(5, -2)。而触控屏、数位板等设备可能使用绝对坐标。绝对坐标的报告格式和逻辑范围必须通过描述符定义清楚。所以在编写 HID 固件时不能只关心报告长度还必须确认每个字段的语义。五、动手实现时的建议先使用 SDK 提供的 HID Keyboard 示例。检查接口描述符和 Report Descriptor。发送一个按键报告再发送释放报告。在文本编辑器中验证结果。确认按键行为正常后再增加鼠标报告。最后根据产品需求调整报告格式和上报机制。测试模拟键盘时应避免在登录界面或可能触发重要操作的环境中直接发送按键。六、常见错误报告长度与描述符不一致。将 HID Usage ID 误当作 ASCII 编码。按下按键后没有发送释放状态。把相对坐标当成绝对坐标。修改了 Report Descriptor却没有同步修改固件实际发送的数据。遇到这些问题时应同时检查描述符和实际传输的数据而不是只修改其中一方。七、本讲小结HID 的核心是设备先描述数据格式再按照这个格式上报状态。理解 Report Descriptor 与实际报告的关系就掌握了开发键盘、鼠标和许多游戏手柄的基础。留给下一讲的问题如果一个设备既要实现键盘又要实现鼠标还想提供 CDC 调试串口是否需要三个 USB 插头下一讲我们来看复合设备如何让一个 USB 设备同时具备多种功能。

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询