# KeyAxis：解析磁轴键盘的模拟量 HID 数据流

> KeyAxis 记录使用 0416:7372 控制器的键盘 HID 键程数据流，并将按键深度映射到虚拟手柄轴。协议文档说明厂商接口、ARM 与 DISARM 命令、64 字节主机消息，以及从抓包中还原的行、列和深度字段。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-06
- 原始资源：<https://github.com/RigZeeel/KeyAxis>
- 一手来源：<https://github.com/RigZeeel/KeyAxis/blob/53a7e1b267083ce8a979aea95635a4391962020a/PROTOCOL.md>
- 目录页面：<https://awesomerea.org/zh/resources/keyaxis-keyboard-hid-case/>
- 记录 JSON：<https://awesomerea.org/resources/keyaxis-keyboard-hid-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/keyaxis-keyboard-hid-case/index.md)

## 使用条件与局限

- **前提条件：**需要 USB ID 为 0416:7372 的键盘和 Windows 10/11 x64；手柄输出还需要 ViGEmBus。
- **前提条件：**从源码运行需要 Python 3.9 或更新版本。
- **局限：**屏幕布局覆盖 68 键；vJoy 输出仍在计划中。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/RigZeeel/KeyAxis/blob/53a7e1b267083ce8a979aea95635a4391962020a/PROTOCOL.md>
2. <https://github.com/RigZeeel/KeyAxis/blob/53a7e1b267083ce8a979aea95635a4391962020a/README.md>

## 同分区更多条目：协议

- [A.O. Smith 热水器：CTA-2045 本地控制与协议研究](https://awesomerea.org/zh/resources/aosmith-water-heater-case/index.md) · 案例
- [j2208-band-tools：基于 J2208 手环协议的直连客户端](https://awesomerea.org/zh/resources/j2208-band-tools-case/index.md) · 案例
- [Eufy Local Light：重建 E10 与 E22 灯具的 BLE 控制](https://awesomerea.org/zh/resources/eufy-local-ha-case/index.md) · 案例
- [OpenPeats：重建 SoundPEATS 耳机控制协议](https://awesomerea.org/zh/resources/openpeats-case/index.md) · 案例
- [hongtai-panel：还原水冷显示屏的 USB 串口协议](https://awesomerea.org/zh/resources/hongtai-panel-case/index.md) · 案例
- [ESPHome ↔ L&S Emotion Control：重建智能灯无线控制客户端](https://awesomerea.org/zh/resources/emotion-control-ha-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。