OpenLogi
设备

MX Master 4

OpenLogi 在 MX Master 4 上能驱动的每个控件、背后对应的 HID++ feature,以及绑定它们的 config.toml。

Logitech 的注册表把这只鼠标记作 model id 2b042 —— OpenLogi 按它取渲染图与热点数据, model id 索引里也用它归档。下面写的是这款产品;你手上那台究竟 报告了什么,以 openlogi diag features 打印的为准。

控件

MX Master 4 侧视图,各控件已编号1234567
  1. 1中键
  2. 2模式切换(DPI)键
  3. 3拇指滚轮
  4. 4手势键
  5. 5前进
  6. 6后退
  7. 7触感面板
控件位置取自 Logitech 为该型号发布的元数据,不是在图上量出来的。

控件在 config.toml 里使用逻辑名。代理只捕获当前绑定需要的控件:

#控件绑定名截取方式
1中键MiddleClick系统输入钩子
2模式切换键DpiToggle0x1b04
3拇指滚轮Thumbwheel、ThumbwheelScrollUp、ThumbwheelScrollDown0x2150
4手势键GestureButton0x1b04
5前进Forward系统输入钩子;macOS 手势捕获还使用 HID++
6后退Back系统输入钩子;macOS 手势捕获还使用 HID++
7触感面板HapticPanel0x1b04 表中一个可截取的 0x01a0 控件

新设备带有两项非原生的默认绑定。手势键使用手势表:上滑为 Mission Control,下滑为显示桌面,左右滑动切换到上一个和下一个标签页,单击为 App Exposé。触感面板会打开 Actions Ring。

中键、后退、前进、手势键和触感面板支持手势模式。模式切换键需要先实测出 raw-XY 能力,才支持手势模式。手势绑定不是单个动作,而是 Up / Down / Left / Right / Click 的表,多个控件可以同时使用手势模式。按住一次手势键,可以连续滑动多次。拇指滚轮不支持手势模式。参见重映射按键。

如果固件为后退或前进上报原始滚轮输入,该键还可以使用按住时水平滚动。只有上报这项能力的设备,按键(Buttons)标签页才会显示该开关。

触感面板是这只鼠标独有、前代没有的控件。它在可重编程控件表里就是一个普通的可截取控件, 因此和别的按键一样绑定。振动本身来自 0x19b0。 按压力度(按多重才算一次点击)来自 0x19c0 ForceSensingButton。

这只鼠标会显示哪些设置

设置按设备自报的 feature id 决定,与它的产品类型无关;下面是 MX Master 4 通常会 报出来的那些:

设置Feature页面
DPI 预设0x2201 AdjustableDpi,或 0x2202 扩展版DPI
SmartShift0x2111 SmartShiftEnhancedSmartShift
滚动方向、滚轮分辨率与平滑滚轮0x2121 HiResWheel滚动
拇指滚轮0x2150 Thumbwheel滚动
触感反馈0x19b0 HapticFeedbackActions Ring
按压力度0x19c0 ForceSensingButton重映射按键
电量0x1004 UnifiedBattery—
Easy-Switch0x1814 ChangeHost;上报时用 0x1815 HostsInfo 读取通道详情Easy-Switch

只有当这台设备的 0x2111 上报可调扭矩时,SmartShift 卡片上才会出现滚动力度(Scrolling force)。某个设置没出现,意味着这台设备没报对应的 feature;以 openlogi diag features 为准,而不是这张表。

当这台设备的 0x19c0 上报软件可以修改力度时,触感面板的控件检查器里会出现按压力度(Press force)。打开按键(Buttons),点击触感面板即可看到。滑块从轻到重,覆盖设备上报的范围;重置按钮把面板恢复为设备的默认力度。在你选择之前,OpenLogi 不改动固件里的力度。只有鼠标读回该力度后,你的选择才会保存;鼠标重新连接时,OpenLogi 会再次写入。

配置

设备块以物理设备为键,而不是型号 —— 同一台机器上的两只 MX Master 4 永远不会共用一个 条目。先在应用里配一次,再从 config.toml 复制生成的键。已知的 unit:… 或 serial:… 身份会跟随设备跨连接方式生效;接收器和直连路径保存在该身份下的 links 中。以下键仅作示例,并非整个型号共用的标识。

schema_version = 9

[devices."unit:6be9d300"]
dpi = 1600
dpi_presets = [800, 1600, 3200]
invert_scroll = false
smooth_wheel = true

[devices."unit:6be9d300".smartshift]
mode = "ratchet"
auto_disengage = 20

[devices."unit:6be9d300".bindings]
DpiToggle = { SetDpiPreset = 2 }
HapticPanel = "ShowActionsRing"
Back = { CustomShortcut = "Cmd+Shift+P" }

[devices."unit:6be9d300".bindings.GestureButton]
Up = "MissionControl"
Down = "ShowDesktop"
Left = "PrevTab"
Right = "NextTab"
Click = "AppExpose"

[devices."unit:6be9d300".bindings.MiddleClick]
Up = "VolumeUp"
Down = "VolumeDown"
Click = "MiddleClick"

上面每个键的含义与完整动作列表,见配置文件。

身份

注册表里的 2b042 并不是固件报出来的东西:MX Master 4 在 0x0003 deviceInformation 里回的是 ext=01 加 PID b042,所以对得上的是末四位而非前缀 —— OpenLogi 正是按末四位 匹配的,原因写在 Model ID 索引里。openlogi list 会在已配对 设备下把这两者原样打印出来。

本页目录