OpenLogi

键盘灯光

在受支持的 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)卡片。该卡片读取键盘的状态,只显示键盘接受的控件。

MX Keys S 的设备标签页,包含背光卡片

设备标签页中的背光卡片。
  • 每台 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。

本页目录