pyRAT - interface for Mad Catz R.A.T. 7

pyRAT is a tool which incorporates all features of the communication with a Mad Catz (Cyborg) R.A.T.7.

$ sudo python pyRAT.py -h

usage: pyRAT.py [-h] [--setdev Vendor Product]
                [--setdpi MODE X Y | --getdpi MODE | --setmode MODE]

pyRAT supports all features of a R.A.T.7. By Dennis Leroy Wigand

optional arguments:
  -h, --help            show this help message and exit
  --setdev Vendor Product
                        Uses the vendor and product info to find the R.A.T.7
                        device.
  --setdpi MODE X Y     Sets the DPI for a desired MODE in X and Y direction.
                        [0-255]
  --getdpi MODE         Gets the DPI for a desired MODE in X and Y direction.
  --setmode MODE        Sets the active dpi mode. [1-4]

R.A.T.7's Protocol

Lorem Ipsum

Change Active DPI Mode

Modes 1 2 3 4

Mode	1	2	3	4
value	0x1000	0x2000	0x3000	0x4000

Read active DPI Mode

command	value	information
type	0xC0
request	0x90
value	0x0
index	0x74
size	0x1
ioBuffer[size]		will contain the active mode

python snippet:

ioBuffer = dev.ctrl_transfer(0xC0, 0x90, 0, 0x74, 1)

c++ snippet:

err = libusb_control_transfer(handle, 0xC0, 0x90, 0x0, 0x74, ioBuffer, 0x1);

Write active DPI Mode

command	value	information
type	0x40
request	0x91
value	0x1000	choose from modes table above
index	0x74
size	0x0

python snippet:

err = dev.ctrl_transfer(0x40, 0x91, 0x1000, 0x74, [])

c++ snippet:

err = libusb_control_transfer(handle, 0x40, 0x91, 0x1000, 0x74, 0, 0x1);

Change DPI Setting for both Axis

Lazer range [0 - 6400]

Example for calculating the index to set the DPI on mode 1 axis 1 and 2 to 6400 (FF = 255).

Mode	Axis	DPI value
1	1	FF
1	2	FF

Read DPI Values of a specific Mode and Axis

command	value	information
type	0xC0
request	0x90
value	0x0
index	0x1173	1 = Mode 1, 1 = Axis 1, 73 = Postfix
size	0x2
ioBuffer[size]		will contain the dpi values

python snippet:

ioBuffer = dev.ctrl_transfer(0xC0, 0x90, 0, int('0x'+str(mode)+str(axis)+'73', 16), 2)

Write DPI Values of a specific Mode and Axis

command	value	information
type	0x40
request	0x91
value	0x11FF	1 = Mode 1, 1 = Axis 1, FF = 255 (maps to 6400 DPI)
index	0x73
size	0x0

python snippet:

err = dev.ctrl_transfer(0x40, 0x91, int('0x'+str(mode)+str(axis)+str(x), 16), 0x73, [])

Don't forget to confirm your changes (generic command):

err = dev.ctrl_transfer(0x40, 0x91, 0x51, 0x70, [])