删除文件 README.md
This commit is contained in:
楼湘缘
@@ -1,110 +0,0 @@
|
||||
# kbd
|
||||
|
||||
> ASUS TUF Gaming A16 FA608 键盘背光命令行工具
|
||||
>
|
||||
> Keyboard backlight CLI for ASUS TUF Gaming A16 FA608 laptops.
|
||||
|
||||
[](LICENSE)
|
||||
[](https://gitee.com/louxian-yuan/fa608-kbd/releases)
|
||||
|
||||
纯 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
|
||||
|
||||
```bash
|
||||
$ kbd color ff6600 # 静态橙色
|
||||
$ kbd breathe 00ff00 2 # 绿色呼吸
|
||||
$ kbd rainbow 1 # 彩虹循环
|
||||
$ kbd toggle # 关 → 开
|
||||
```
|
||||
|
||||
## 安装 / Installation
|
||||
|
||||
### Deb 包（推荐）
|
||||
|
||||
```bash
|
||||
sudo dpkg -i fa608-kbd_1.0.0_amd64.deb
|
||||
```
|
||||
|
||||
安装后 systemd 服务自动启用，重启无需任何操作。
|
||||
|
||||
### 源码编译
|
||||
|
||||
```bash
|
||||
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.
|
||||
|
||||
## 许可 / License
|
||||
|
||||
MIT © 2026 楼湘缘
|
||||
Reference in New Issue
Block a user