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>
This commit is contained in:
commit
25f3e31b8f
4 files changed
+453
No files matched your search
@@ -0,0 +1,55 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user