# alienware-m15-rgb：Linux 下控制 m15 R2 灯光设备

> alienware-m15-rgb 通过 HID 报告在 Linux 下控制 Alienware m15 R2 的逐键键盘灯和机身灯。协议笔记记录 Darfon API_V5 功能报告序列及 AW-ELC API_V4 输出报告，并说明电源按钮灯的单独设置方法。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/Louisreed/alienware-m15-rgb>
- 一手来源：<https://github.com/Louisreed/alienware-m15-rgb/blob/3a7bd4487048aa224287efce217c561e2224a7dc/docs/PROTOCOL.md>
- 目录页面：<https://awesomerea.org/zh/resources/alienware-m15-rgb-case/>
- 记录 JSON：<https://awesomerea.org/resources/alienware-m15-rgb-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/alienware-m15-rgb-case/index.md)

## 使用条件与局限

- **前提条件：**需要配备文中 Darfon 与 AW-ELC 控制器的 Alienware m15 R2，并能在 Linux 访问 hidraw。
- **前提条件：**udev 规则可启用非 root 访问；壁纸配色功能还需要 ImageMagick。
- **局限：**其他采用相同键盘协议的笔记本仅被列为可能兼容，尚未确认。
- **许可：**GPL-3.0-or-later 许可证。

## 一手来源

1. <https://github.com/Louisreed/alienware-m15-rgb/blob/3a7bd4487048aa224287efce217c561e2224a7dc/docs/PROTOCOL.md>
2. <https://github.com/Louisreed/alienware-m15-rgb/blob/3a7bd4487048aa224287efce217c561e2224a7dc/README.md>

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

- [Ideal Clima Nemo 1000：重建本地 Tuya MCU 控制](https://awesomerea.org/zh/resources/ideal-clima-nemo-local-control-case/index.md) · 案例
- [Switch 2 Pro Controller：将 USB HID 报告桥接至 Windows XInput](https://awesomerea.org/zh/resources/windows-switch2-pro-controller-case/index.md) · 案例
- [cyberboard-cli：重建 CyberBoard R4 配置写入](https://awesomerea.org/zh/resources/cyberboard-cli-case/index.md) · 案例
- [gm1356-recordings：通过 USB-HID 协议读取声级计](https://awesomerea.org/zh/resources/gm1356-recordings-case/index.md) · 案例
- [TwoTrees SK1：重建显示屏 UART 接口](https://awesomerea.org/zh/resources/twotrees-sk1-display-case/index.md) · 案例
- [KW330 OBD Data Access：重建扫描仪 USB 数据流](https://awesomerea.org/zh/resources/kw330-obd-datastream-case/index.md) · 案例

## 关于此条目

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