Files
mangavalkandClaude Opus 5.5 f4eb036a98 Fix zone 2 placement, add colour correction and white balance
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>
2026-11-19 16:05:14 +01:00

3.2 KiB
Raw Permalink Blame History

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 = 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.