# pro2-linux：重建 Logitech PRO 2 LIGHTSPEED 的 Linux 控制功能

> pro2-linux 根据 Logitech G PRO 2 LIGHTSPEED 的 HID++ 2.0 交互及 0x07 板载配置格式，在 Linux 上实现鼠标设置功能。Python 工具与 libratbag 补丁覆盖 DPI、回报率、RGB 和按键配置，协议笔记记录了功能 ID 与报文布局。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/opigod/pro2-linux>
- 一手来源：<https://github.com/opigod/pro2-linux/blob/9855f1a9f3ee78f957cf669f15e12fa088301ad9/docs/protocol.md>
- 目录页面：<https://awesomerea.org/zh/resources/pro2-linux-case/>
- 记录 JSON：<https://awesomerea.org/resources/pro2-linux-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/pro2-linux-case/index.md)

## 使用条件与局限

- **前提条件：**需要 Linux、Logitech G PRO 2 LIGHTSPEED、Python 3.10+、Meson、Ninja、C 编译器、GTK 3/PyGObject 及 libratbag 构建依赖。
- **局限：**写入前需备份板载配置；写入会持久保存在鼠标中。
- **测试证据：**作者报告在一台设备上测试了有线 USB；接收器支持仍需更多设备测试。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/opigod/pro2-linux/blob/9855f1a9f3ee78f957cf669f15e12fa088301ad9/docs/protocol.md>
2. <https://github.com/opigod/pro2-linux/blob/9855f1a9f3ee78f957cf669f15e12fa088301ad9/README.md>
3. <https://github.com/opigod/pro2-linux/blob/9855f1a9f3ee78f957cf669f15e12fa088301ad9/docs/status.md>

## 同分区更多条目：协议

- [beam-revival：基于电机协议研究的 Beam+ 本地控制系统](https://awesomerea.org/zh/resources/beam-revival-case/index.md) · 案例
- [NXOSC Reborn：还原 Waves Nx Head Tracker 的 BLE 输出](https://awesomerea.org/zh/resources/nxosc-reborn-case/index.md) · 案例
- [BLE LED Matrix Controller：还原 96×20 显示屏的 GIF 上传流程](https://awesomerea.org/zh/resources/ble-led-matrix-controller-case/index.md) · 案例
- [LSC Smart Connect / Battletron：还原局域网灯具控制](https://awesomerea.org/zh/resources/lsc-battletron-bridge-case/index.md) · 案例
- [Razer Key Light Chroma：基于灯光控制协议的 SignalRGB 客户端](https://awesomerea.org/zh/resources/razer-key-light-chroma-protocol-case/index.md) · 案例
- [lochinvar-native-modbus：绘制 Knight 锅炉遥测寄存器映射](https://awesomerea.org/zh/resources/lochinvar-native-modbus-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。