# GAMEKB-K17：重建宏键盘配置协议

> 实现 GAMEKB-K17/HCY-K017 宏键盘的厂商 HID 配置协议，写入按键映射、固件宏和 RGB 设置后再读回核对。协议文档区分已测试命令、未确认观察和其他设备的研究结果。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-17
- 收录于：2026-10-17
- 原始资源：<https://github.com/dvdarkin/gamekb-k17>
- 一手来源：<https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/gamekb-k17-case/>
- 记录 JSON：<https://awesomerea.org/resources/gamekb-k17-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/gamekb-k17-case/index.md)

## 使用条件与局限

- **前提条件：**软件包版本为 3.0.0，需要 Python 3.11+ 和 hidapi；可选编辑器使用 tkinter。设备 USB 标识为 0816:0220。
- **测试证据：**项目测试了 Windows；其他 hidapi 平台尚未测试。Linux 配置需要相应设备权限。
- **范围：**文档范围包括 18 个可重映射控件和最多 16 个固件宏。音量旋钮由固件固定。
- **测试证据：**读回核对和中断写入顺序属于项目结合协议文档报告的行为。
- **许可：**采用 MIT 许可证。所审阅一手文件明确说明逆向了厂商 WebHID 配置器。

## 一手来源

1. <https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/README.md>
2. <https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/docs/PROTOCOL.md>
3. <https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/pyproject.toml>
4. <https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/LICENSE>

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

- [cooler-lcd：Thermalright 显示屏协议实现](https://awesomerea.org/zh/resources/cooler-lcd-case/index.md) · 案例
- [NJFE：用于电脑检查的 Soulear 相机协议桥接](https://awesomerea.org/zh/resources/njfe-ear-camera-bridge-case/index.md) · 案例
- [hw-harness：扫描仪 USB 协议调查](https://awesomerea.org/zh/resources/hw-harness-reference-case/index.md) · 案例
- [Roborock Local Server：自托管替代 Roborock 扫地机云端](https://awesomerea.org/zh/resources/roborock-local-server-cloud-case/index.md) · 案例
- [pypush：Apple 推送协议的 Python 客户端](https://awesomerea.org/zh/resources/pypush-apns-protocol-case/index.md) · 案例
- [PixMob 红外逆向工程：在家控制活动手环](https://awesomerea.org/zh/resources/pixmob-ir-protocol-case/index.md) · 案例

## 关于此条目

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