支持的设备
OpenLogi v0.8.15 可识别的 Logitech 设备与功能门控条件。
173 台
OpenLogi 会先探测硬件功能表,再启用控件。设备型号用于识别硬件,但不保证设备具有某项功能。
OpenLogi 如何判断设备支持
OpenLogi 探测设备后,会按测得的功能决定显示哪些标签页和控件。它不会按设备的营销型号或上报类别选择这些面板。
启动时离线的设备没有测得的功能表。OpenLogi 会暂按设备类别推定功能,使主机侧绑定仍可使用。
使用以下命令检查当前硬件:
openlogi list # 已连接设备、接收器槽位和电池状态
openlogi diag features # 当前设备上报的 HID++ 功能 ID
openlogi diag controls # 可重映射控件及其能力标志功能映射
下表列出 OpenLogi 使用的功能门控条件。只有已连接设备上报所需功能时,才会出现对应行。
| 功能 | HID++ 功能 | GUI 位置 | 文档 |
|---|---|---|---|
| 按键或键位绑定与手势 | 0x1b00~0x1b04 ReprogControls | 按键(Buttons)标签页的所选控件编辑器;键盘使用 按键(Keys)标签页 | 按键重映射 |
| DPI 与回报率 | 0x2201 AdjustableDpi 或 0x2202 ExtendedAdjustableDpi;回报率使用 0x8060 或 0x8061 | 指针(Pointer)标签页的 灵敏度(DPI)卡片 | DPI和回报率 |
| SmartShift | 0x2111 SmartShiftWheelEnhanced,回退到 0x2110 SmartShiftWheel | 指针标签页的 SmartShift 卡片 | SmartShift |
| 拇指滚轮 | 0x2150 Thumbwheel,或 0x6501 Gestures2 的手势 46 | 指针标签页的 SmartShift 卡片 | 滚动 |
| 主滚轮分辨率、反转与平滑 | 0x2121 HiResWheel;反转还需要设备上报 has_invert 标志 | 指针标签页的 滚动(Scrolling)卡片 | 滚动 |
| 按住以横向滚动 | 0x1b04 中支持原始滚轮报告的可转移 后退(Back)或 前进(Forward)控件 | 按键标签页的 后退或前进控件编辑器 | 按键重映射 |
| Fn 锁定与主机系统布局 | 0x40a0、0x40a2 或 0x40a3 FnInversion;0x4531 MultiPlatform | 设备(Device)标签页的键盘卡片,其中有 Fn 锁定(Fn Lock)和保持系统布局(Keep OS layout) | 键盘 |
| 键盘背光 | 0x1982 Backlight2 | 设备标签页的 背光(Backlight)卡片 | 键盘灯光 |
| Easy-Switch 主机名与操作系统 | 0x1815 HostsInfo | 设备标签页的 Easy-Switch 卡片 | Easy-Switch |
| 静态 RGB 键盘灯光 | 0x8070、0x8071、0x8081 或 0x8080 | 灯光(Lighting)标签页的 灯光卡片 | 键盘灯光 |
| Litra 补光灯的电源、亮度与色温 | 可用时使用 0x1990 Illumination;原始 HID 仍是回退路径 | 补光灯的 灯光(Lighting)标签页中的 灯光卡片 | Litra 补光灯 |
| 摄像头预览与画面控制 | UVC;没有 HID++ 功能门控 | 摄像头(Camera)标签页中的预览和摄像头控制(Camera controls)卡片 | 摄像头 |
| 锁定键提示 | 0x4220 LockKeyState | 设置窗口中的 锁定键提示(Lock key notifications) | 屏幕提示 |
| 小键盘 LCD 键绑定、键面与绑定页 | 不经过 HID++ 功能:键盘 HID++ 接口上的厂商报文;翻页键使用 0x1b04 | 按键(Keys)标签页的键盘按键网格与页面栏 | MX Creative Keypad |
设备覆盖范围
接收器
OpenLogi 识别下表列出的精确 Logitech USB 厂商和产品组合。表中所有 ID 的厂商 ID 都是 046d。
| 接收器系列 | 产品 ID | 支持情况 |
|---|---|---|
| Logi Bolt | c548 | 发现、枚举和 GUI 配对 |
| Unifying | c52b、c532 | 枚举和 Unifying 配对流程 |
| Nano | c534、c537 | 通过兼容 Unifying 的协议枚举;GUI 配对流程会列出这类接收器(未在 Nano 硬件上验证) |
| Lightspeed | c539、c53a(Powerplay)、c53f、c541、c547、c54d | 枚举和设备控制;GUI 配对流程会列出这类接收器并使用 Unifying 配对流程(未在 Lightspeed 硬件上验证) |
Nano 与 Lightspeed 接收器使用兼容 Unifying 的 HID++ 1.0 协议。OpenLogi 仍将其产品系列与 Unifying 区分开来。
补光灯、摄像头与耳机
OpenLogi 通过完整原始 HID 身份识别 Litra Glow(046d:c900)和 Beam(046d:c901)。它会先尝试 HID++ 0x1990 并读取状态,再在无法读取该功能时使用已验证的原始 HID 报告路径。
每个 Logitech UVC 摄像头都按厂商 ID 识别。对于 USB 描述符不含产品字符串的摄像头,注册表会提供对应的产品名称。
G733 耳机通过 HID++ 0x1f20 上报电池电压、充电状态和链路状态。OpenLogi 将已关闭的 G733 视为未连接,并按测得电压估算电池百分比。
G735 接收器会作为具有稳定身份的独立设备被识别。它目前不支持电池、静音或侧音控制。
小键盘
OpenLogi 通过 USB-C 线连接时按 USB 标识识别 MX Creative Keypad(046d:c354),因为它的固件不报设备类型。它的 9 个 LCD 键可以像普通按键一样绑定,显示所绑定动作的图标,最多可保存 15 页绑定。详见 MX Creative Keypad。
鼠标与轨迹球控件
MX Ergo 与 MX Ergo S 的精确模式槽位会映射到 DPI 切换(DPI Toggle)控件。因此,按键标签页可以显示和绑定该控件。
M720 Triathlon 使用多平台手势按键控件,而不是 MX 手势按键控件。OpenLogi 会识别该控件的原始 XY 能力,用于绑定和手势。
尚未支持
OpenLogi 尚未为 G735 实现耳机控制协议。静音和侧音等音频控件仍不可用。
检查设备并报告未知硬件
以上命令会显示 OpenLogi 能读取的接收器身份、功能表和控件标志。若 Logitech 设备未显示或功能表不完整,请遵循贡献指南提交报告。