# Redragon K652: macOS control from driver and HID analysis

> Redragon K652 macOS control reconstructs the keyboard's HID configuration protocol from decompilation of its Windows driver with REA and Ghidra. A SwiftUI app and k652ctl CLI use IOKit reports for wired lighting and key settings, while the protocol document ties fields to driver functions and records device observations. The tested model is the Azure K652GG-RGB-PRO.

- Type: Case study
- Targets: Protocol
- Category: Community REA investigations
- Relationship: Author-reported mixed workflow
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/samuelpjacobsen/redragon-k652-macos>
- Primary source: <https://github.com/samuelpjacobsen/redragon-k652-macos/blob/54f847a4a915564e9846bc682aed8608626175d4/docs/PROTOCOLO.md>
- Catalog page: <https://awesomerea.org/resources/redragon-k652-macos-case/>
- Record JSON: <https://awesomerea.org/resources/redragon-k652-macos-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/redragon-k652-macos-case/index.md)

## Requirements & limits

- **Prerequisites:** macOS 14 or later, Apple Command Line Tools and a Redragon K652 Azure keyboard for the documented hardware path.
- **Limits:** Some hardware effects blanked the tested keyboard; wired key-matrix writing and speed direction remain untested.
- **License:** MIT license.

## Primary sources

1. <https://github.com/samuelpjacobsen/redragon-k652-macos/blob/54f847a4a915564e9846bc682aed8608626175d4/docs/PROTOCOLO.md>
2. <https://github.com/samuelpjacobsen/redragon-k652-macos/blob/54f847a4a915564e9846bc682aed8608626175d4/README.md>

## More in Protocols

- [AK·LINK: reconstructing AJAZZ AK820 Pro HID control](https://awesomerea.org/resources/aklink-case/index.md) · Case study
- [Etrel Load Guard Configurator: reconstructing the meter's UDP protocol](https://awesomerea.org/resources/etrel-load-guard-configurator-case/index.md) · Case study
- [hw-harness: scanner USB protocol investigation](https://awesomerea.org/resources/hw-harness-reference-case/index.md) · Case study
- [Roborock Local Server: a self-hosted stand-in for Roborock’s vacuum cloud](https://awesomerea.org/resources/roborock-local-server-cloud-case/index.md) · Case study
- [pypush: a Python client for Apple’s push protocol](https://awesomerea.org/resources/pypush-apns-protocol-case/index.md) · Case study
- [PixMob IR reverse engineering: controlling event wristbands at home](https://awesomerea.org/resources/pixmob-ir-protocol-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.