OpenLogi

HID++ 参考

Logitech 用于通过 USB HID 配置鼠标、键盘与接收器的厂商协议。与 Options+ 相同,OpenLogi 直接使用它。

HID++ 是 Logitech 用于通过 USB HID 配置鼠标、键盘与接收器的厂商协议。OpenLogi 通过 hidpp Rust crate 直接使用它,与 Options+ 所用的协议相同。

两个代际

  • HID++ 1.0 —— 一组固定编号的寄存器(registers)。主要用于较旧的 Unifying 接收器进行配对与设备枚举。
  • HID++ 2.0 —— 一组可发现的功能(features),每个由 16 位 ID 标识(写作 0xZZZZ,例如 0x2201)。现代设备使用这一代。

功能发现

2.0 设备通过两个根功能暴露其能力:

  • 0x0000 root —— 将功能 ID 解析为其运行时的 功能索引(feature index)
  • 0x0001 featureSet —— 枚举设备实现的所有功能。

由此,OpenLogi 进一步查询各个功能:设备信息、电量、DPI、SmartShift 等。参见功能索引

身份标识

线路上有两种命名设备的方式:接收器以 USB 厂商/产品 ID 标识(见 接收器),设备则以它通过 0x0003 报告的 model id 标识 —— 后者悉数收录在 model id 索引

归属与版权

本 HID++ 参考是为 OpenLogi 项目原创整理的摘要,依据公开资料与 hidpp 实现描述 Logitech 的 HID++ 1.0 / 2.0 协议,未逐字复制任何 Logitech 文档。“Logitech”“Unifying”“Logi Bolt”“Options+” 为 Logitech 的商标;OpenLogi 为独立项目,与 Logitech 无关联,亦未获其授权或认可。 内容按“现状”提供,不含任何形式的担保。

本页目录