{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/Louisreed/alienware-m15-rgb/blob/3a7bd4487048aa224287efce217c561e2224a7dc/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "alienware-m15-rgb implements Linux control of the Alienware m15 R2's per-key keyboard and chassis lighting through HID reports. Its protocol notes describe the Darfon API_V5 feature-report sequence and AW-ELC API_V4 output reports, including separate handling for the power-button light.",
  "description_zh": "alienware-m15-rgb 通过 HID 报告在 Linux 下控制 Alienware m15 R2 的逐键键盘灯和机身灯。协议笔记记录 Darfon API_V5 功能报告序列及 AW-ELC API_V4 输出报告，并说明电源按钮灯的单独设置方法。",
  "entry_url": "https://awesomerea.org/resources/alienware-m15-rgb-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/alienware-m15-rgb-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/Louisreed/alienware-m15-rgb/blob/3a7bd4487048aa224287efce217c561e2224a7dc/docs/PROTOCOL.md",
  "group": "cases",
  "id": "alienware-m15-rgb-case",
  "json_url": "https://awesomerea.org/resources/alienware-m15-rgb-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/alienware-m15-rgb-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/alienware-m15-rgb-case/index.md",
  "name": "alienware-m15-rgb: Linux control of the m15 R2 lighting controllers",
  "name_zh": "alienware-m15-rgb：Linux 下控制 m15 R2 灯光设备",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "An Alienware m15 R2 with the documented Darfon and AW-ELC controllers and Linux hidraw access are required.",
    "A udev rule enables access without root; wallpaper matching additionally requires ImageMagick.",
    "Other notebooks using the same keyboard protocol are described as possible but unconfirmed.",
    "GPL-3.0-or-later license."
  ],
  "requirements_zh": [
    "需要配备文中 Darfon 与 AW-ELC 控制器的 Alienware m15 R2，并能在 Linux 访问 hidraw。",
    "udev 规则可启用非 root 访问；壁纸配色功能还需要 ImageMagick。",
    "其他采用相同键盘协议的笔记本仅被列为可能兼容，尚未确认。",
    "GPL-3.0-or-later 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/Louisreed/alienware-m15-rgb",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}