Model ID 索引

Model id 是 Logitech 自家工具用来标识产品的字符串。OpenLogi 用它作为逐设备配置 的键，也用它在 assets.openlogi.org 上取到设备的渲染图 与热点数据。

这个 id 由什么拼成

设备通过 0x0003 deviceInformation 报告自己的身份：最多三个 model_id PID —— 固件声明的每种传输方式各一个（USB、 eQuad、BTLE、Bluetooth）—— 外加一字节 extended_model_id，即颜色批次一类的产线属性。 openlogi list 会在每台已配对设备下把两者都打出来：

     model_ids=[b042,0000,0000] ext=02 serial=— unit_id=00010203 transports=usb+equad

注册表里的 id 就是这两者相接，扩展字节在前：

model id = {extended_model_id:x}{model_id[0]:04x}

于是 ext=02 加 model_ids=[b042,…] 得到 2b042。

四位的 id 则是裸 PID —— 早于扩展字节的那批 depot，以及注册表仅凭 USB PID 识别的东西： 接收器（c548）、摄像头（085e）、G 系音频设备（0a9b）。

可信的是末四位

首位是 Logitech 注册表的记法，并不是从设备上读出来的，两者在实机上会对不上：MX Master 4 在注册表里是 2b042，而设备报告的是 ext=01。同一个产品在不同传输方式下的 PID 也 不同 —— MX Master 3S 走 Bluetooth LE 时报 b034，走接收器时报 b043，注册表两个都 列了。

OpenLogi 的匹配顺序也是这样：先用完整的 ext + pid 字符串，再单用末尾的 PID，最后才 退到「固件 codename 对注册表显示名」。查这份索引也照此办理 —— 用设备报出来的那四位， 别管前缀。

索引

注册表列出的每个 model id 各占一行：一个产品若认多个 id，就出现多次 —— 因为你手上拿着 的正是 id。

同样的数据以 JSON 形式提供在 /model-ids.json，顺序一致，每行 { id, name, kind, depot }，供脚本以及任何不想去爬表格的东西取用。其中 depot 是该 设备资产在 assets.openlogi.org 上所在的目录。

这份索引到哪儿为止

• 数据源就是注册表。 收录的是 Logi Options+ 为之提供资产的产品。只由 G HUB 驱动的 设备，以及 Options+ 之前的老设备，都不在其中 —— 它们的 id 真实存在，只是不在这里。
• 只有注册表列出的 id。 设备最多报三个 PID，而多数 depot 只公布一个，所以你手上的 id 可能正是这份索引没为该产品写出的那种传输方式。末四位搜索就是为此准备的。
• 接收器是以产品身份出现的，用它被识别的 USB PID 标注。OpenLogi 如何与之通信，见 接收器。
• 在列不等于支持，不在列也不是判决。 OpenLogi 会打开任何带 HID++ 厂商 collection 的 Logitech HID 接口，所以不在这里的设备照样可能被驱动；而在这里的耳机与麦克风， OpenLogi 根本不去配置。每个产品暴露什么，见 支持的设备。