# Saitek Cyborg R.A.T.3 Mouse

The Saitek Cyborg R.A.T.3 Mouse is a 7 buttons USB gaming mouse sold by Mad Catz. This article explains how to make it work with any desktop manager.

## Installation

No driver installation is required. The mouse should be detected at boot or whenever it is hot-plugged.

## Issues

After being plugged, the mouse will seems to work, but you may experience different issues :

- You can't move windows around when grabbing the window's title bar. (happens with Openbox and other Window manager)
- You can't click on buttons.
- You can't get the focus on windows.
- You can't open menus, even with keyboard shortcuts.
- Display doesn't refresh (using Xcompmgr or Cairo Compmgr)

## Solution

With root privileges, create and edit the file `/etc/X11/xorg.conf.d/50-vmmouse.conf` (see xorg).

Add the following content :

    Section "InputDevice"
        Identifier     "Mouse0"
        Driver         "evdev"
        Option         "Name" "Saitek Cyborg R.A.T.3 Mouse"
        Option         "Vendor" "06a3"
        Option         "Product" "0ccc"
        Option         "Protocol" "auto"
        Option         "Device" "/dev/input/event4"
        Option         "Emulate3Buttons" "no"
        Option         "Buttons" "7"
        Option         "ZAxisMapping" "4 5"
        Option         "ButtonMapping" "1 2 3 4 5 6 7 0 0 0 0 0 0 0"
        Option         "Resolution" "3200"
    EndSection

After restarting your X server, the mouse should be fully functional, including the two lateral buttons. If not, or if you need more informations about configuring gaming mice, see All Mouse Buttons Working.

Alternative Method (Manually ButtonMapping):

Please note that there are two different versions of the R.A.T.3 mouse which are Saitek and Madcatz, this must be input correctly into the "MatchProduct" or you will run into the same issues.

First find out the ID and the Name of the mouse :

    xinput list | grep "id"

In you should see your mouse labeled as "Madcatz Mad Catz R.A.T.3 Mouse" or "Saitek Cyborg R.A.T.3 Mouse". Take the id and then input the following command :

    xinput query-state ID

(Where ID corresponds to the ID of your mouse)

Note which mode color is currently active (red/blue/purple) and which numbers say "up" and "down", switch it to the next one, and retype the above command. Do that one more time.

Now that you know which buttons correspond to the modes, you should be able to edit your xorg.conf file appropriately. Open in your chosen editor:

    /etc/X11/xorg.conf

You'll want to insert a block that's similar to this (My configuration for a MadCatz R.A.T.3):

    # RAT3 mouse
    Section "InputClass"
     Identifier "Mouse Remap"
     MatchProduct "Madcatz Mad Catz R.A.T.3 Mouse"
     MatchDevicePath "/dev/input/event*"
     Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 0 0 0 13 14 15 16 17 18"
    EndSection

This configuration worked for me on my old Saitek Cyborg R.A.T.3:

    # RAT3 mouse
    Section "InputClass"
     Identifier "Mouse Remap"
     MatchProduct "Saitek Cyborg R.A.T.3 Mouse"
     MatchDevicePath "/dev/input/event*"
     Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"
    EndSection

The important thing is the "ButtonMapping" and the "MatchProduct" part. Just go through the list of buttons sequentially until you get to the buttons that correspond to the all the modes combined and enter 0s instead.

Example:

    U = up
    D = down
                            U U U U U D D U U D D D  U  U
    Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"

Though this page is directed at the R.A.T.3 mouse this should work with any other R.A.T mouse. After you modified the xorg.conf file just restart X.

## See also

- http://ubuntuforums.org/showthread.php?t=2126385
- http://askubuntu.com/questions/92546/cyborg-r-a-t-3-gaming-mouse-stops-working-after-a-while-and-or-misbehaves

Category:

- Mice