支持的设备
OpenLogi 能驱动的罗技鼠标、键盘、轨迹球、补光灯与摄像头。
具体功能表以 OpenLogi 从设备读取的为准,可以通过运行 openlogi diag features 来查看。
| 图标 | 按键 |
|---|---|
| 已完全支持。 | |
| 视固件而定。 | |
| 暂不支持。 |
鼠标与轨迹球
| 家族 | 按键 | 手势 | DPI | SmartShift | 拇指滚轮 | 触感 |
|---|---|---|---|---|---|---|
| MX Master 4 | ||||||
| MX Master 3 / 3S | ||||||
| MX Master 2S | 0x2110 | 0x6501 | ||||
| MX Anywhere 2S / 3 / 3S | ||||||
| MX Vertical、MX Ergo、Ergo M575 | ||||||
| Lift、Signature、Pebble、M 系列 | ||||||
| G 系列无线(G305、G502 X、G903…) |
SmartShift 在 MX Master 3 / 3S / 4 与当前 MX 系列鼠标上是增强版 0x2111;MX Master
2S 应答的是旧版 0x2110,它的横向滚轮也是 0x6501 手势描述符而非 0x2150
拇指滚轮功能。两条路径 OpenLogi 都驱动。
键盘
F 区重映射走系统输入钩子,因此对任何键盘都有效,包括下表没列到的。各家族的差别在于板上设置:
| 家族 | Fn-lock | 主机切换 | 背光 | RGB |
|---|---|---|---|---|
| MX Keys、Keys S、Keys Mini | ||||
| MX Mechanical、Mechanical Mini | ||||
| Craft、Ergo K860、K380 / K480、K580 | ||||
| G915、G815、G513 等 RGB 键盘 |
RGB 通过 0x8070 以单色静态方式写入,而非逐键效果;MX Keys 的白色背光是
0x1982,从 CLI 驱动。参见灯光。
补光灯与摄像头
| 设备 | USB ID | 可控项 |
|---|---|---|
| Litra Glow | 046d:c900 | 开关、20–250 流明、2700–6500 K(步进 100 K) |
| Litra Beam | 046d:c901 | 开关、20–250 流明、2700–6500 K(步进 100 K) |
| 任意罗技摄像头 | 厂商 046d | UVC 画面参数、实时预览、预设 |
Litra 匹配用的是完整的原始 HID 路由——厂商 ID、产品 ID、用途页 0xff43、用途
0x0202——而不只是产品 ID,这样厂商报文不会落到无关的 HID 集合上。其他 Litra
型号暂未驱动。摄像头则相反:它们是标准 UVC 设备,识别只看厂商 ID,不涉及型号表。参见补光灯与摄像头。
接收器
| 接收器 | USB ID | 状态 |
|---|---|---|
| Logi Bolt | 046D:C548 | 可发现、枚举,并在 GUI 中完成通行码配对 |
| Unifying | 046D:C52B、C532、C537 | 可枚举与驱动;尚未实现配对新设备 |
| Lightspeed | 046D:C539、C53F、C547 | 与 Unifying 同一套代码路径,仅显示名不同 |
C537 是 G602 附带的 Nano 接收器;C539 随 G502 LIGHTSPEED 与 G Pro Wireless
出货,C53F 是 G305 的 nano 接收器,C547 随 G915、G502 X LIGHTSPEED 等较新的 G
系列硬件出货。Lightspeed 接收器应答与 Unifying 相同的 HID++ 1.0
寄存器,因此走同一条枚举、路由与配对路径,只是显示名不同。详见接收器参考。
不在这些 ID 之列的接收器不会被识别为接收器,配对在它上面的设备也就看不见。设备本身仍可通过蓝牙或数据线使用——蓝牙直连与有线设备在各自的
HID++ 通道上以设备索引 0xFF 寻址,没有配对槽位这层间接。在 macOS 上,Lift、Signature
这类蓝牙直连鼠标需要输入监控权限才会出现,参见连接设备。
OpenLogi 目前还不支持
- 音频设备。 配对在接收器上的耳机会出现在设备清单里,但没有对应面板——没有 sidetone,也没有均衡器。
- 板载配置。 OpenLogi 从不写入 G 系列的板载配置(
0x8100)。它自己的按应用配置在主机侧,跟随前台应用切换。 - 非 Logitech 硬件。 HID++ 枚举与摄像头枚举都按 Logitech 厂商 ID(
0x046d)过滤。
检查你自己的设备
openlogi list # 当前连接了什么,按接收器分组,附电量
openlogi diag features # 当前设备上报的每一个 HID++ 功能
openlogi diag controls # 可重映射控件及其能力标志如果 openlogi list
什么都没找到,常见原因是 Logi Options+ 仍占用着接收器,或者权限缺失——参见连接设备。
功能面板
OpenLogi 读取一次设备的功能表(0x0001 FeatureSet),按其中出现的功能 ID
决定开哪些面板,而不看设备自报的类型——一只把自己报错成别的类型的鼠标,仍然保留固件真正支持的全部面板。
| 面板 | 驱动它的功能 | 说明 |
|---|---|---|
| 按键与手势 | 0x1b00–0x1b04 ReprogControls | 可转移(divertable)的控件经由系统输入钩子重映射 |
| DPI 预设 | 0x2201 AdjustableDpi 或 0x2202 ExtendedAdjustableDpi | 任一 ID 都会打开面板,两者都能驱动 |
| SmartShift | 0x2111 SmartShiftEnhanced,回退到 0x2110 | MX Master 2S 是典型的只有 0x2110 的情形 |
| 滚动反转 | 0x2121 HiResWheel 且上报 has_invert | 设备原生反转,直接写入设备 |
| 滚轮分辨率 | 0x2121 HiResWheel | 与反转彼此独立地读写 |
| 拇指滚轮 | 0x2150 Thumbwheel,或 0x6501 Gestures2 的 46 号手势 | 后者覆盖 MX Master 2S 一代的鼠标 |
| 触感反馈 | 0x19b0 HapticFeedback | |
| Haptic Sense Panel | 0x1b04 控件表中可转移的 0x01a0 控件 | MX Master 4 的触感区,与其他控件一样可绑定 |
| RGB 颜色 | 0x8070 ColorLedEffects,其次 0x8081 PerKeyLighting2,再次 0x8080 PerKeyLighting | 优先 0x8070:固定效果能覆盖正在运行的板载配置 |
| 背光 | 0x1982 Backlight | MX Keys 的白色背光,不是 RGB |
| Fn-lock | 0x40a3 FnInversionForMultiHost,回退到 0x40a2 | 多主机键盘按 Easy-Switch 槽位分别保存 |
| 主机切换 | 0x1814 ChangeHost 配合 0x1815 HostsInfo | 没有 0x1815 时切换照常可用 |
| 电量 | 0x1004 统一电量、0x1000 旧版,或 0x1001 电压 | G 系列无线设备只上报电压 |
上表中的 ID 可在 HID++ 参考中查阅。