{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/samuelpjacobsen/redragon-k652-macos/blob/54f847a4a915564e9846bc682aed8608626175d4/README.md"
  ],
  "category": "community-case-studies",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "Redragon K652 macOS 控制项目使用 REA 和 Ghidra 反编译 Windows 驱动，重建键盘的 HID 配置协议。SwiftUI 应用和 k652ctl 命令行工具通过 IOKit 报告控制有线灯效及按键设置；协议文档将字段对应到驱动函数，并记录设备观测。已测试型号为 Azure K652GG-RGB-PRO。",
  "entry_url": "https://awesomerea.org/resources/redragon-k652-macos-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/redragon-k652-macos-case/",
  "evidence_url": "https://github.com/samuelpjacobsen/redragon-k652-macos/blob/54f847a4a915564e9846bc682aed8608626175d4/docs/PROTOCOLO.md",
  "group": "rea",
  "id": "redragon-k652-macos-case",
  "json_url": "https://awesomerea.org/resources/redragon-k652-macos-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/redragon-k652-macos-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/redragon-k652-macos-case/index.md",
  "name": "Redragon K652: macOS control from driver and HID analysis",
  "name_zh": "Redragon K652：基于驱动与 HID 分析的 macOS 控制工具",
  "record_type": "resource",
  "relationship": "community-reported-mixed-workflow",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "macOS 14 or later, Apple Command Line Tools and a Redragon K652 Azure keyboard for the documented hardware path.",
    "Some hardware effects blanked the tested keyboard; wired key-matrix writing and speed direction remain untested.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 macOS 14 或更新版本、Apple Command Line Tools，以及用于文档所述硬件路径的 Redragon K652 Azure 键盘。",
    "部分硬件灯效会使测试键盘熄灯；有线按键矩阵写入和速度方向尚未在硬件上测试。",
    "采用 MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/samuelpjacobsen/redragon-k652-macos",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}