# gs5-rgb：Creative Sound Blaster GS5 灯光协议

> gs5-rgb 从 USB 抓包还原 Creative Sound Blaster GS5 灯光协议，并提供 Linux Python 库和命令行工具。协议笔记记录 HID 报文格式、确认响应、灯效和状态读取；客户端可控制七段灯带、亮度及内置效果。

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

## 使用条件与局限

- **前提条件：**需要 Linux、Python 3.8 或更新版本、通过 USB 连接的 GS5，以及通过所附 udev 规则取得 hidraw 访问权限。
- **局限：**作者测试了固件 1.25.251009.1430；其他固件版本、模式 07 和断电后的设置保留情况仍待确认。
- **许可：**MIT 许可证。

## 一手来源

1. <https://github.com/JRiley2025/gs5-rgb/blob/4319840a103954ddf8a349970704d01caf255467/README.md>
2. <https://github.com/JRiley2025/gs5-rgb/blob/4319840a103954ddf8a349970704d01caf255467/PROTOCOL.md>

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

- [Telly Remote：重建 TYRC-1 遥控器的蓝牙与红外控制](https://awesomerea.org/zh/resources/telly-remote-case/index.md) · 案例
- [Wave Buds：JBL Wave Buds 控制协议客户端](https://awesomerea.org/zh/resources/wave-buds-case/index.md) · 案例
- [manifold-558s-ble：还原 testo 558s 测量消息协议](https://awesomerea.org/zh/resources/manifold-558s-ble-case/index.md) · 案例
- [attackshark-x11prov2：解析 X11 PRO V2 鼠标配置协议](https://awesomerea.org/zh/resources/attackshark-x11prov2-case/index.md) · 案例
- [AULA Hub：还原 AULA F99 Pro 键盘协议](https://awesomerea.org/zh/resources/aula-hub-f99-protocol-case/index.md) · 案例
- [hpcs330：重建 Hopoo 光谱仪串口协议](https://awesomerea.org/zh/resources/hpcs330-case/index.md) · 案例

## 关于此条目

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