OpenLogi

键盘

通过 HID++ 绑定罗技键盘控件,使用系统钩子重映射功能键,并管理键盘设置。

OpenLogi 提供两条互相独立的键盘绑定路径。选择键盘后,打开它的按键(Keys)标签页。该页会显示此设备可用的路径。

两种键盘绑定路径

属性HID++ 控件系统钩子功能键
范围一台上报可重编程控件的罗技键盘本机接收的键盘事件
标识HID++ 0x1b04 16 位控件 IDesc、f1–f19,可带修饰键
配置位置[devices."unit:6be9d300".bindings][keyboard.bindings]
绑定作用域按物理设备保存,应用配置文件可以覆盖全局作用于本机
GUI按键标签页显示带标记的 HID++ 控件按键标签页回退到功能键行
平台macOS、Linux 与 WindowsmacOS 与 Windows;Linux 不捕获键盘事件

在 GUI 中绑定按键

在按键标签页点击一个按键,会打开它的面板。面板列出与鼠标按键选择器相同的动作目录,另有高级功能(Power User)分区。选择一个动作即可完成绑定。

MX Keys S 的按键标签页,列出每个按键的绑定

MX Keys S 的按键标签页。

要清除绑定,选择原生功能(Native function),或再次选择当前已绑定的动作。两种方式都会删除覆盖设置,按键恢复原生行为。v0.8.15 的功能键面板没有恢复默认值(Reset to defaults)按钮。

HID++ 键盘控件

上报 HID++ 0x1b04 可重编程控件的罗技键盘,按 16 位控件 ID(CID)绑定按键。键盘图片带有控件标记时,按键(Keys)标签页会显示这些控件。否则,标签页会显示系统钩子功能键行。

你可以使用下表中的目录名,或对 openlogi diag controls 报告的任意可接管控件使用 control:0x<cid>。未绑定的控件保留固件动作。在 v0.8.15 中,已保存的 None 不表示未绑定。代理会接管并抑制该控件。要恢复固件动作,必须删除控件条目。

[devices."unit:6be9d300".bindings]
KeySearch = "MissionControl"
KeyCalculator = { CustomShortcut = "Cmd+Shift+C" }
"control:0x01f3" = "ShowActionsRing"

控件目录

OpenLogi 为以下 43 个 HID++ 控件命名。键盘上报对应控件时,按键(Keys)标签页会使用本地化标签。

配置键按键标签CID
KeyBrightnessDown屏幕亮度减小键0x00c7
KeyBrightnessUp屏幕亮度增大键0x00c8
KeyBacklightDown背光减弱键0x00e2
KeyBacklightUp背光增强键0x00e3
KeyMissionControl调度中心键0x00e0
KeyLaunchpad启动台键0x00e1
KeyShowDesktop显示桌面键0x006e
KeySearch搜索键0x00d4
KeyDictation听写键0x0103
KeyEmoji表情符号键0x0108
KeyScreenCapture截屏键0x010a
KeyPrintScreen截屏键(Print Screen)0x00bf
KeyMicMute麦克风静音键0x011c
KeyPreviousTrack上一曲键0x00e4
KeyPlayPause播放/暂停键0x00e5
KeyPlayPauseTrack播放/暂停键(曲目)0x0141
KeyNextTrack下一曲键0x00e6
KeyMute静音键0x00e7
KeyVolumeDown音量减小键0x00e8
KeyVolumeUp音量增大键0x00e9
KeyCalculator计算器键0x000a
KeyLock锁定键0x006f
KeyDoNotDisturb勿扰模式键0x011d
KeyEmojiHeartEyes爱心眼表情键0x0104
KeyEmojiCrying哭泣表情键0x0105
KeyEmojiSmiley微笑表情键0x0106
KeyEmojiTears笑哭表情键0x0107
KeyLookUp查询键0x00ea
KeyAppSwitch切换应用键0x0100
KeyAppSwitchLaunchpad切换应用/启动台键0x0109
KeyHomeHome 键0x0118
KeyEndEnd 键0x0119
KeyPageUpPage Up 键0x011a
KeyPageDownPage Down 键0x011b
KeyMultiPlatformAppSwitch切换应用键(多平台)0x00ba
KeyMultiPlatformHome主屏幕键(多平台)0x00bb
KeyMultiPlatformMenu菜单键(多平台)0x00bc
KeyMultiPlatformInsertInsert 键(多平台)0x00be
KeyLanguageSwitch切换输入语言键0x00dd
KeyCircle圆形键0x01a3
KeyTriangle三角形键0x01a4
KeyDiamond菱形键0x01a5
KeyStar星形键0x01a6

全局功能键重映射

系统钩子路径可重映射任意键盘上的 Escape 键和 F1 至 F19 键。这些绑定是全局的,因此不属于某台罗技设备,也不属于应用配置文件。触发器写作 [修饰键+]按键。有效修饰键为 shift、control(ctrl)、option(alt)和 command(cmd)。

固件不会把 Fn 作为普通按键修饰键上报,因此 Fn 不能作为触发器。在按键(Keys)面板选择原生功能(Native function),可以清除功能键绑定。GUI 会从 [keyboard.bindings] 删除该触发器。

[keyboard.bindings]
f1 = "MissionControl"
"shift+f2" = "ShowDesktop"
"cmd+f5" = { CustomShortcut = "Cmd+Shift+P" }

操作列表包含操作环(Actions Ring)。其高级功能(Power User)分区可编辑输入文本…(Type Text…)和工作流…(Workflow…)动作。配置格式还支持用于即时按键组合的 CustomShortcut。完整说明见配置参考。

设备设置

选择键盘后,打开设备(Device)标签页。键盘卡片包含已连接键盘支持的设置。

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

设备标签页中的键盘设置。

Fn 锁定(Fn Lock)会使直接按下 F 区时发送 F1–F12。印刷功能随后改为 Fn + 按键。OpenLogi 支持 HID++ 0x40a3、0x40a2 与 0x40a0 Fn 反转功能,并会在键盘重连时重新应用已保存的设置。

保持系统布局(Keep OS layout)适用于暴露 HID++ 0x4531 的多平台键盘。启用后,代理会在键盘连接时为此计算机的操作系统设置键盘布局。键盘布局快捷键改变布局后,代理会再次设置布局。

相关键盘功能

Easy-Switch。Easy-Switch 通道保存已配对的电脑,并可与其他设备协调主机切换。详见 Easy-Switch。

键盘灯光。背光控制和静态 RGB 灯光独立于按键绑定。详见键盘灯光。

锁定键指示器。键盘上报状态变化时,OpenLogi 可以在屏幕上显示 Caps Lock、Num Lock 与 Scroll Lock。详见屏幕提示。

**状态:**键盘上报 0x1b04 specialKeysMSEButtons 时,HID++ 控件绑定可在 macOS、Linux 与 Windows 上使用。Fn 锁定使用 0x40a0 fnInversion、0x40a2 fnInversionWithDefaultState 或 0x40a3 fnInversionMultiHost。保持系统布局使用 0x4531 multiPlatform。全局功能键重映射可在 macOS 与 Windows 上使用。Linux 不捕获键盘事件。

本页目录