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>
58 lines
3.2 KiB
Markdown
58 lines
3.2 KiB
Markdown
# 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.
|