Case study
GAMEKB-K17: reconstructing a macropad configuration protocol
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.
Requirements and limitations
- 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; family resemblance does not establish another model’s compatibility.
- Read-back verification and interruption ordering are project claims backed by protocol documentation, not independent device tests by this catalog.
- MIT license. The reviewed primary files establish reverse engineering of the vendor WebHID configurator, but do not establish REA involvement.
About this entry
- Type
- Case study
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Targets
- Protocol
Sources reviewed
The description was reviewed against primary sources. This does not establish runtime testing, security auditing or verified compatibility.
Primary sources
- https://github.com/dvdarkin/gamekb-k17/blob/e61f444793857c0e10a31692674335ee4ee9c89e/README.md
- 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