{
  "added_at": "2026-11-06",
  "additional_evidence_urls": [
    "https://github.com/RigZeeel/KeyAxis/blob/53a7e1b267083ce8a979aea95635a4391962020a/README.md"
  ],
  "category": "reconstruction-cases",
  "description_en": "KeyAxis documents the HID travel stream of keyboards using the 0416:7372 controller and turns key depth into virtual gamepad axes. Its protocol notes specify the vendor interface, ARM and DISARM commands, 64-byte host reports and row, column and depth fields recovered from captured traffic.",
  "description_zh": "KeyAxis 记录使用 0416:7372 控制器的键盘 HID 键程数据流，并将按键深度映射到虚拟手柄轴。协议文档说明厂商接口、ARM 与 DISARM 命令、64 字节主机消息，以及从抓包中还原的行、列和深度字段。",
  "entry_url": "https://awesomerea.org/resources/keyaxis-keyboard-hid-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/keyaxis-keyboard-hid-case/",
  "evidence_url": "https://github.com/RigZeeel/KeyAxis/blob/53a7e1b267083ce8a979aea95635a4391962020a/PROTOCOL.md",
  "group": "cases",
  "id": "keyaxis-keyboard-hid-case",
  "json_url": "https://awesomerea.org/resources/keyaxis-keyboard-hid-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/keyaxis-keyboard-hid-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/keyaxis-keyboard-hid-case/index.md",
  "name": "KeyAxis: decoding a magnetic keyboard's analog HID stream",
  "name_zh": "KeyAxis：解析磁轴键盘的模拟量 HID 数据流",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "A keyboard exposing USB ID 0416:7372 and Windows 10/11 x64 are required; gamepad output needs ViGEmBus.",
    "Running from source requires Python 3.9 or later.",
    "The on-screen layout covers 68 keys; vJoy output is planned.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 USB ID 为 0416:7372 的键盘和 Windows 10/11 x64；手柄输出还需要 ViGEmBus。",
    "从源码运行需要 Python 3.9 或更新版本。",
    "屏幕布局覆盖 68 键；vJoy 输出仍在计划中。",
    "采用 MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/RigZeeel/KeyAxis",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}