Files
rat8plus-rgb/README.md
T
mangavalkandClaude Opus 5.5 25f3e31b8f Mad Catz R.A.T. 8+ lighting control without the vendor software
SignalRGB plugin streaming live colours through a firmware LED command
(no storage writes), plus a Python CLI for live and stored profile colours.
Protocol from the vendor app and a disassembly of firmware v18.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 15:39:04 +01:00

56 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Mad Catz R.A.T. 8+ lighting without the vendor software
USB ID 12CF:0C05, firmware 18. Protocol decompiled from the vendor app (`Controllers\RAT8P.dll`).
Details are in the docstring at the top of `rat8.py`.
- `MadCatz_RAT8Plus.js`: SignalRGB plugin, installed in `Documents\WhirlwindFX\Plugins`.
Restart SignalRGB after changing it.
- `rat8.py`: command-line tool (`pip install hidapi`).
- Run `python rat8.py backup profile_backup.json` before you change anything, so
`restore` can put the mouse back exactly as it was.
The plugin streams colours live with a firmware command the vendor app never uses
(`[12, C4, 3, 4, 1, zone, R, G, B]`, see "Firmware" below). That command goes straight
to the LED driver with no storage writes, so it doesn't wear anything out. It handles
110+ updates a second. The `static`/`breathe`/`off` commands below change the stored
profile instead (one storage write each), which survives replugging.
Zones: 0 = under the scroll wheel, 1 = palm logo, 2 = DPI button.
```
python rat8.py live ff0000 00ff00 0000ff # RAM only, until release/replug
python rat8.py release # back to the stored lighting
python rat8.py info
python rat8.py static 00aaff # all zones
python rat8.py static ff0000 00ff00 0000ff # scroll palm dpi
python rat8.py breathe ff00ff -p 3
python rat8.py off
python rat8.py restore profile_backup.json
```
Close SignalRGB (or disable the plugin) before you use the script, because both share
one reply buffer on the mouse.
## Firmware
The firmware isn't in this repo, because it's Mad Catz's code. To get it, decompile
`MADCATZ R8+ Firmware Update Tool.exe` with `ilspycmd -p`. The `Firmware` byte array in
`GAMINGAPP.Properties.Resources.resx` is the whole image: 49,152 bytes, version 18
(the version the mouse reports). It's unencrypted ARM Cortex-M0 code, loaded at address 0
(initial SP 0x20002000, so 8 KB RAM; reset handler at 0x86E3), which fits a Sonix
SN32F2-series chip. The addresses below are for that image, disassembled as Thumb with capstone.
The updater sends `[12, 0xC4, 5, 0, 0]` to put the mouse into update mode, then 24 chunks with
`[10, 0x10, chunk, checksum, 2048 bytes]`. **Never send command 5 by hand.** The mouse would sit
in update mode waiting for an image. The protocol has no command to read flash back.
Useful addresses:
- `0x319C`: feature-report handler. It dispatches on the prefix byte: C4 goes to 0x2F94,
and C5, DE and DF go to raw/debug handlers.
- `0x2F94`: C4 command switch (jump table at 0x2FA8). 0 reload, 1 reset, 3 live LED, 5 update
mode, 6 calibrate, 7 select profile, 8 version, 12 read profile, 15 raw byte access, 22 active profile.
- `0x2E74`: command 3. The first call pauses the effect engine (0x4ED2) and blanks the LEDs.
Sub 4 sets colours: mode 1 is one zone via 0x6C3C, mode 2 is all zones via 0x6C8C, or off.
Sub 3/3 releases (0x4F1E).
- `0x6B90`: writes to the 9-channel LED driver over bus 0. Register 1 holds the 9 PWM bytes
(3 zones × RGB), and writing register 0x16 latches them.