Zone 2 is the light under the thumb wheel, not the DPI button. The scroll-wheel and logo LEDs have much weaker blue than the thumb-wheel LED, so the plugin now trims their red and green (measured by eye) and applies an optional gamma curve. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.2 KiB
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 inDocuments\WhirlwindFX\Plugins. Restart SignalRGB after changing it.rat8.py: command-line tool (pip install hidapi).- Run
python rat8.py backup profile_backup.jsonbefore you change anything, sorestorecan 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 = under the thumb wheel.
The scroll-wheel and logo LEDs have much weaker blue than the thumb-wheel LED; the plugin
scales their red to 15% and green to 10% ("White Balance") plus a gamma setting.
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 thumb
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.