kbd

ASUS TUF Gaming A16 FA608 键盘背光命令行工具

Keyboard backlight CLI for ASUS TUF Gaming A16 FA608 laptops.

纯 C 编写，单二进制 14KB。运行时仅依赖 libhidapi-hidraw0。

Single C binary (14KB). One runtime dependency: libhidapi-hidraw0.

特性 / Features

🎨 RGB 灯效 — 12 种模式：静态、呼吸、彩虹、脉冲、彗星等
☀️ 亮度调节 — 4 级亮度（0-3），支持 toggle 切换
⚡ 开机即用 — systemd 服务开机自动初始化，无需手动 kbd init
📦 Deb 包分发 — dpkg -i 一键安装，依赖自动补齐
🪶 轻量 — 14KB 二进制，零 bloat
🔧 免 sudo — 安装后普通用户直接使用

演示 / Demo

$ kbd color ff6600       # 静态橙色
$ kbd breathe 00ff00 2   # 绿色呼吸
$ kbd rainbow 1          # 彩虹循环
$ kbd toggle             # 关 → 开

安装 / Installation

Deb 包（推荐）

sudo dpkg -i fa608-kbd_1.0.0_amd64.deb

安装后 systemd 服务自动启用，重启无需任何操作。

源码编译

sudo apt install libhidapi-dev   # Debian/Ubuntu
git clone https://gitee.com/louxian-yuan/fa608-kbd.git
cd fa608-kbd
make
sudo make install

用法 / Usage

kbd on|off|toggle           亮度开关
kbd 0-3                     亮度等级
kbd color RRGGBB            静态颜色
kbd breathe RRGGBB [speed]  呼吸灯效
kbd rainbow [speed]         彩虹循环
kbd mode N RRGGBB [speed]   自定义模式
kbd init                    切换 EC 模式（systemd 已自动处理）

参数说明：

参数	取值	说明
`RRGGBB`	6 位十六进制	RGB 颜色，如 `ff6600`
`speed`	0-2	速度：0=慢, 1=中, 2=快
`N`	0-12（除 9）	灯效模式（见下表）

灯效模式 / LED Modes

值	模式	Mode
0	静态	Static
1	呼吸	Breathe
2	彩虹循环	Rainbow Cycle
3	彩虹波	Rainbow Wave
4	星空	Star
5	雨滴	Rain
6	高亮	Highlight
7	激光	Laser
8	涟漪	Ripple
10	脉冲	Pulse
11	彗星	Comet

模式 9 无效（硬件不支持），≥12 自动降级为 Pulse。

为什么需要 / Why This Exists

FA608 使用 ITE51368 键盘控制器，通过 I2C HID (0B05:19B6) 连接。 Linux 下该设备默认处于 Windows Dynamic Lighting 模式，此时所有 WMI 和 sysfs 背光指令均被硬件忽略。

本工具在启动时向设备发送一条 HID Feature Report (0x46 0x01)，将其切换至 Embedded Controller 模式。此后 asus::kbd_backlight sysfs 接口即可正常控制亮度与 RGB。

The FA608 uses an ITE51368 keyboard controller over I2C HID. On Linux it defaults to Windows Dynamic Lighting mode, which silently ignores all backlight commands. This tool sends a single HID feature report to switch it to Embedded Controller mode, after which the standard kernel interface works correctly.

致谢 / Credits

感谢 DaniilBaida/asus-tuf-a16-linux 提供了 ITE51368 切换 EC 模式的 HID Feature Report 思路。

3.4 KiB Raw Permalink Blame History Unescape Escape

kbd