{
  "added_at": "2026-10-17",
  "additional_evidence_urls": [
    "https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/docs/PROTOCOL.md",
    "https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/pyproject.toml",
    "https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/LICENSE"
  ],
  "category": "reconstruction-cases",
  "description_en": "Implements the vendor HID configuration protocol for the GAMEKB-K17/HCY-K017 macropad. It writes key mappings, firmware macros and RGB settings, then reads them back; protocol notes separate tested commands from unconfirmed observations and other-device findings.",
  "description_zh": "实现 GAMEKB-K17/HCY-K017 宏键盘的厂商 HID 配置协议，写入按键映射、固件宏和 RGB 设置后再读回核对。协议文档区分已测试命令、未确认观察和其他设备的研究结果。",
  "entry_url": "https://awesomerea.org/resources/gamekb-k17-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/gamekb-k17-case/",
  "evidence_url": "https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/README.md",
  "group": "cases",
  "id": "gamekb-k17-case",
  "json_url": "https://awesomerea.org/resources/gamekb-k17-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/gamekb-k17-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/gamekb-k17-case/index.md",
  "name": "GAMEKB-K17: reconstructing a macropad configuration protocol",
  "name_zh": "GAMEKB-K17：重建宏键盘配置协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "scope",
    "testing",
    "license"
  ],
  "requirements": [
    "Package 3.0.0 requires Python 3.11+ and hidapi; the optional editor uses tkinter. Hardware identity is USB 0816:0220.",
    "Windows is project-tested; other hidapi platforms are untested. Linux configuration requires suitable device permissions.",
    "The documented scope includes 18 remappable controls and up to 16 firmware macros. The volume dial is fixed in firmware.",
    "Read-back verification and interruption ordering are project claims backed by protocol documentation.",
    "MIT license. The reviewed primary files establish reverse engineering of the vendor WebHID configurator."
  ],
  "requirements_zh": [
    "软件包版本为 3.0.0，需要 Python 3.11+ 和 hidapi；可选编辑器使用 tkinter。设备 USB 标识为 0816:0220。",
    "项目测试了 Windows；其他 hidapi 平台尚未测试。Linux 配置需要相应设备权限。",
    "文档范围包括 18 个可重映射控件和最多 16 个固件宏。音量旋钮由固件固定。",
    "读回核对和中断写入顺序属于项目结合协议文档报告的行为。",
    "采用 MIT 许可证。所审阅一手文件明确说明逆向了厂商 WebHID 配置器。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/dvdarkin/gamekb-k17",
  "verification": "source-reviewed",
  "verified_at": "2026-10-17"
}