OpenLogi
设备

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、gridBottomRightHID++ 接口上的厂商报文,不经过 HID++ feature
左、右翻页键KeyLeftPaging、KeyRightPaging0x1b04

打开键盘的按键标签页,点击一个键即可打开它的面板。面板里的动作和其他按键相同,用法见 键盘。

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;键盘只有一页时,文件里不写这一项。所有动作名见配置。

本页目录