# Cosmic Byte Firestorm Controller: a USB protocol client for mouse settings

> Cosmic Byte Firestorm Controller implements a Linux client for the mouse's recovered USB settings protocol. Its Python CLI sends control and interrupt transfers to configure lighting effects, per-DPI indicator colours and sensitivity levels, while PROTOCOL.md records packet structures and command sequences.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-06
- Original resource: <https://github.com/electrondefuser/cbfirestorm>
- Primary source: <https://github.com/electrondefuser/cbfirestorm/blob/65802f360916030cffa2207ac5f72fae183fe0ca/README.md>
- Catalog page: <https://awesomerea.org/resources/cosmic-byte-firestorm-controller-case/>
- Record JSON: <https://awesomerea.org/resources/cosmic-byte-firestorm-controller-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/cosmic-byte-firestorm-controller-case/index.md)

## Requirements & limits

- **Prerequisites:** Linux and a Cosmic Byte Firestorm mouse with VID 0x04d9 and PID 0xa09f; USB access typically requires sudo.
- **Prerequisites:** Running from source requires Python, pyusb and PyYAML.
- **Testing evidence:** Device support was tested only with the named Firestorm model.
- **License:** GPL-3.0 licence.

## Primary sources

1. <https://github.com/electrondefuser/cbfirestorm/blob/65802f360916030cffa2207ac5f72fae183fe0ca/README.md>
2. <https://github.com/electrondefuser/cbfirestorm/blob/65802f360916030cffa2207ac5f72fae183fe0ca/PROTOCOL.md>

## More in Protocols

- [Centerpiece Projects: decoding Finalmouse Centerpiece USB control](https://awesomerea.org/resources/finalmouse-centerpiece-protocol-case/index.md) · Case study
- [FAAC E145 Gate Connect: reconstructing EasyBoard gate commands](https://awesomerea.org/resources/faac-e145-gate-connect-case/index.md) · Case study
- [stagg-net: investigating the Fellow Stagg EKG kettle UART](https://awesomerea.org/resources/stagg-net-case/index.md) · Case study
- [TOZO Control: a Linux earbuds client built from the TOZO BLE protocol](https://awesomerea.org/resources/tozo-control-case/index.md) · Case study
- [BMS RS485 Service Suite: reconstructing a battery-service bus protocol](https://awesomerea.org/resources/bms-rs485-service-suite-case/index.md) · Case study
- [Petkit Local: reconstructing feeder cloud and fountain BLE controls](https://awesomerea.org/resources/petkit-local-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.