键盘灯光
在受支持的 Logitech 键盘上控制静态 RGB 灯光和存储在键盘中的背光设置。
OpenLogi 将静态 RGB 灯光与键盘的白色背光分开控制。键盘上报的 HID++ 特性决定显示哪些控件。
| 键盘能力 | HID++ 特性 | 控制位置 | 控件 | 存储位置 |
|---|---|---|---|---|
| 支持 RGB 的键盘 | 0x8070、0x8071、0x8081 或 0x8080 之一 | 灯光(Lighting)标签页 | 一种静态颜色、开关和亮度(Brightness) | config.toml;键盘重新连接时,代理会重新应用已保存的设置 |
| 支持白色背光的键盘 | 0x1982 | 设备(Device)标签页 → 背光(Backlight)卡片 | 点亮按键(Light the keys),以及键盘上报支持的其他控件 | 键盘的非易失性内存;不会写入 config.toml |
| 仅支持旧版 Backlight1 的键盘 | 0x1981 | 没有控件 | 不受支持 | 不会写入 |
静态 RGB 灯光
在设备库中选择支持 RGB 的键盘,然后打开灯光(Lighting)标签页。OpenLogi 检测到至少一种受支持的 RGB 特性后,才会显示该标签页。
- 选择颜色色块会启用灯光,并应用该静态颜色。
- 亮度(Brightness)的取值为
0~100,步长为5。松开滑块时才会写入数值。 - OpenLogi 只提供整块键盘的静态颜色。OpenLogi 不提供动态特效或逐键颜色编辑器。
在配置中
OpenLogi 按物理设备键保存 RGB 选择。OpenLogi 会重新加载代理,因此键盘重新连接后,代理可以再次应用该选择。
[devices."receiver:aabbccdd:slot:1".lighting]
enabled = true
color = "ff0000"
brightness = 80灯光关闭时,enabled、color 和 brightness 仍保留在配置中。重新启用灯光会恢复已保存的颜色和亮度。完整参考见配置。
协议与诊断
OpenLogi 按以下顺序尝试 RGB 路径:0x8070、0x8071、0x8081、0x8080。优先使用的 0x8070 路径会选择易失性的固定颜色特效,因此可以替换正在运行的板载配置文件。
OpenLogi 使用 0x8071 时,代理会在运行期间保持软件控制权,并在退出时把控制权交还给固件。代理会串行处理写入和交还操作,因此旧的交还操作不会覆盖后来的颜色选择。
使用诊断命令可为有线 RGB 键盘设置纯色。该命令使用与 GUI 相同的 HID++ 写入路径。
openlogi diag lighting ff0000先退出 Logi Options+。两个应用程序都需要独占 HID++ 访问权限。
白色背光
在线且上报 0x1982 的键盘会在设备(Device)标签页显示背光(Backlight)卡片。该卡片读取键盘的状态,只显示键盘接受的控件。

- 每台
0x1982键盘都提供点亮按键(Light the keys)。键盘保存此设置,因此它在每台电脑上都生效。 - 键盘支持自动模式时,会显示自动亮度(Automatic brightness)。该控件按键盘周围的光线调整亮度。
- 键盘支持软件选择亮度级别时,会显示亮度(Brightness)。按钮从
0到键盘上报的最高级别。选择级别会关闭自动亮度(Automatic brightness)。 - 键盘支持省电时,会显示省电模式(Battery saving)。电量低时,键盘会关闭背光。
关闭点亮按键(Light the keys)会禁用自动亮度(Automatic brightness)和亮度(Brightness),但不会禁用省电模式(Battery saving)。固件而非设置关闭按键灯时,卡片会显示电量严重不足,背光已关闭。或环境足够明亮,背光已关闭。
卡片将每项接受的更改写入键盘,并用键盘的回读结果替换显示的状态。背光设置仅存储在键盘的非易失性内存中,不会写入 config.toml。
使用命令行
openlogi backlight 会读取当前状态,以及所选键盘提供的控件。同一组持久化 0x1982 控件也可从命令行使用:
openlogi backlight auto on
openlogi backlight level 3
openlogi backlight battery-saving on亮度级别必须介于 0 与键盘上报的级别数减一之间。openlogi backlight off 会保持 LED 熄灭,不受环境光或手部靠近影响。openlogi backlight on 会恢复已存储的模式和级别。
该命令需要正在运行的 OpenLogi 代理。它通过代理发送每次更改,因此已打开的背光卡片会显示新状态。设备选择规则见命令行。
屏幕上的背光级别
OpenLogi 收到背光变化事件时,会显示短暂的背光(Backlight)屏幕指示器。该指示器显示当前级别和上报的最高级别,并在 1,500 ms 后隐藏。相关屏幕提示见通知。
**状态:**macOS、Linux 和 Windows。协议细节见
0x8070 colorLedEffects、
0x8071 rgbEffects、
0x8081 perKeyLighting2、
0x8080 perKeyLighting 和
0x1982 backlight。