MX Creative Keypad
OpenLogi 如何绑定 MX Creative Keypad 的 9 个 LCD 键和 2 个翻页键、绘制键面,以及在多个绑定页之间切换。
MX Creative Keypad 通过 USB-C 线连接,USB 标识为 046d:c354。它的固件不报设备类型,所以
OpenLogi 按这个 USB 标识识别它。下文描述的是这款产品;你手上这台设备实际支持什么,以
openlogi diag features 的输出为准。
控件
键盘上有两类按键,它们到达 OpenLogi 的途径不同:
| 控件 | 配置名 | 上报途径 |
|---|---|---|
| 9 个 LCD 键,3×3 排列 | gridTopLeft、gridTopMiddle、gridTopRight、gridMiddleLeft、gridMiddle、gridMiddleRight、gridBottomLeft、gridBottomMiddle、gridBottomRight | HID++ 接口上的厂商报文,不经过 HID++ feature |
| 左、右翻页键 | KeyLeftPaging、KeyRightPaging | 0x1b04 |
打开键盘的按键标签页,点击一个键即可打开它的面板。面板里的动作和其他按键相同,用法见 键盘。
OpenLogi 只监听 LCD 键,不为捕获它们向键盘写入任何内容。所以未绑定的键仍然没有作用,和不运行 OpenLogi 时一样。
按应用配置在这个键盘上和普通键盘一样可用。在键盘的按键标签页 选择一个配置后,该应用在前台时,这个配置的绑定生效。
键面
每个已绑定的 LCD 键显示其动作的图标,和设置窗口、Actions Ring 里的图标相同。未绑定的键不显示内容。键盘重新连接或切换页面时,agent 会重新绘制键面。
绑定页
键盘开始时只有一页绑定。在按键标签页的页面栏里可以添加页面,最多 15 页。每一页为 9 个 LCD 键各保存一套绑定。翻页键不属于某一页,它们的绑定在每一页都相同。
键盘有多于一页时,左翻页键默认绑定上一个键盘页,右翻页键默认绑定下一个键盘页。翻页会 循环:在最后一页执行下一个键盘页会回到第 1 页。这两个动作也可以绑定到 LCD 键上。只有一页时, 翻页键保持原生功能。
移除一页会删除该页在所有应用配置中的绑定。OpenLogi 会先询问再移除。
agent 运行期间会记住当前页。config.toml 只保存键盘有几页。
配置
和其他设备一样,设备块以物理设备为键。先在应用里配置一次键盘,再从 config.toml 复制它生成的
键。下面的键仅作示例。
[devices."unit:3f9a21c0"]
keypad_pages = 2
[devices."unit:3f9a21c0".bindings]
gridTopLeft = "Copy"
gridTopMiddle = "Paste"
gridMiddle = { CustomShortcut = "Cmd+Shift+4" }
"page2:gridTopLeft" = "VolumeUp"
"page2:gridBottomLeft" = "VolumeDown"
KeyLeftPaging = "PreviousKeypadPage"
KeyRightPaging = "NextKeypadPage"第 1 页的键直接用配置名。后面各页的键要加 pageN: 前缀,因此键名要加引号。keypad_pages 是
页数,取值 1 到 15;键盘只有一页时,文件里不写这一项。所有动作名见配置。