https://wiki.archlinux.org/api.php?action=feedcontributions&user=Mabalenk&feedformat=atomArchWiki - User contributions [en]2024-03-29T01:22:26ZUser contributionsMediaWiki 1.41.0https://wiki.archlinux.org/index.php?title=Mad_Catz_Mouse&diff=625038Mad Catz Mouse2020-07-13T10:21:30Z<p>Mabalenk: /* RAT7 or RAT9 Partial Fix */ Corrected minor typo.</p>
<hr />
<div>[[Category:Mice]]<br />
[[ja:Mad Catz]]<br />
Mad Catz produces a series of gaming mice, for example the Saitek Cyborg R.A.T.3 Mouse (7 buttons USB wired) or the R.A.T9 (7 buttons USB wireless). The mice do not work properly in X without some reconfiguration. This article explains how to make it work with any desktop manager.<br />
<br />
==Installation==<br />
<br />
No driver installation is required.<br />
The mouse should be detected at boot or whenever it is hot-plugged.<br />
<br />
{{note|On some systems the ''MatchProduct'' string may vary, therefore, you can use the command {{ic|xinput list}} }}<br />
<br />
==Issues==<br />
<br />
After being plugged, the mouse seems to work, but you may experience different issues :<br />
<br />
* You cannot move windows around when grabbing the window's title bar. (happens with [[Openbox]] and other [[Window manager]])<br />
* You cannot click on buttons.<br />
* You cannot get the focus on windows.<br />
* You cannot open menus, even with keyboard shortcuts.<br />
* Display does not refresh (using [[Xcompmgr]])<br />
* Closing certain windows restores functionality until the mouse locks into a new window.<br />
<br />
==The Disable Button Solution==<br />
<br />
The issues are caused by an interaction between R.A.T Mode button and the X Server. To restore proper functionality, the 'Mode' button must be disabled, as follows:<br />
<br />
With root privileges, create and edit the file '''{{ic|/etc/X11/xorg.conf.d/50-vmmouse.conf}}''' (see [[xorg]]).<br />
<br />
Add the following content :<br />
<br />
Section "InputDevice"<br />
Identifier "Mouse0"<br />
Driver "evdev"<br />
Option "Name" "Saitek Cyborg R.A.T.3 Mouse"<br />
Option "Vendor" "06a3"<br />
Option "Product" "0ccc"<br />
Option "Protocol" "auto"<br />
Option "Device" "/dev/input/event4"<br />
Option "Emulate3Buttons" "no"<br />
Option "Buttons" "7"<br />
Option "ZAxisMapping" "4 5"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 0 0 0 0 0 0 0"<br />
Option "Resolution" "3200"<br />
EndSection<br />
<br />
After restarting your X server, the mouse should be fully functional, including the two lateral buttons. You may restart the X server with the following command:<br />
<br />
sudo systemctl restart <display-manager><br />
<br />
where display manager is {{ic|sddm}}, {{ic|lightdm}} or {{ic|gdm3}}. If not, or if you need more information about configuring gaming mice, see [[All Mouse Buttons Working]].<br />
<br />
== RAT7 or RAT9 Partial Fix ==<br />
This is the configuration file that will get your R.A.T. 7 or R.A.T. 9 mouse working properly under Linux. <br />
*Does not fix the change-profile button for RAT9, this profile needs more adjustment or just do not push it.<br />
<br />
{{ic|/etc/X11/xorg.conf.d/910-rat.conf}}:<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
# Option "Resolution" "3200"<br />
# Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
You can define different keystrokes applied to each mouse button by defining them in {{ic|~/.xbindkeysrc}} eg.:<br />
<br />
# pressing mouse button 7 sends keystroke: 2<br />
"xvkbd -text 2"<br />
m:0x0 + b:7<br />
# pressing mouse button 8 sends keystroke: Space<br />
"xvkbd -text "\[SPACE]""<br />
m:0x0 + b:8<br />
# pressing mouse button 9 sends keystroke: F8<br />
"xvkbd -text "\[F8]""<br />
m:0x0 + b:9<br />
# pressing mouse button 10 sends keystroke: CursorLeft<br />
"xvkbd -text "\[Left]""<br />
m:0x0 + b:10<br />
# pressing mouse button 11 sends keystroke: Shift+F2<br />
"xvkbd -text "\[Shift]\[F2]""<br />
m:0x0 + b:11<br />
<br />
A very good article on setting up the Mad Catz M.M.O.7 mouse with Linux is written [https://delightlylinux.wordpress.com/2013/07/29/using-the-mad-catz-m-m-o-7-with-linux-mint-and-ubuntu/ here].<br />
<br />
==Manual Button Mapping Fix==<br />
<br />
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.<br />
<br />
First find out the ID and the Name of the mouse :<br />
<br />
xinput list | grep "id"<br />
<br />
In you should see your mouse labeled as "Madcatz Mad Catz R.A.T.3 Mouse" or "Saitek Cyborg R.A.T.3 Mouse". Note the device id number and then input the following command :<br />
<br />
xinput query-state ID<br />
<br />
(Where ID corresponds to the ID number of your mouse)<br />
<br />
Note which 'mode' color is currently active (red/blue/purple) and which button numbers correspond to the current 'mode' by being either '''"up"''' or '''"down"'''. Change the mouse 'mode' and and retype the above command, noting which buttons change state to match the 'mode'.<br />
<br />
Example:<br />
<br />
U = up<br />
D = down<br />
U U U U U D D U U D D D U U <br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
<br />
Where buttons 10, 11, and 12 have been identified as 'mode' buttons, so they can be disabled by with zeros.<br />
<br />
When you have identified which button numbers correspond to the mouse 'modes', you should be able to edit your {{ic|xorg.conf}} file and disable them by inserting a zero in the appropriate point in the button sequence. <br />
<br />
Open in your chosen editor:<br />
<br />
/etc/X11/xorg.conf or<br />
/etc/X11/xorg.conf.d/910-rat-xx.conf<br />
<br />
Create a block that overwrites the mode buttons as listed for your mouse model in chapter '''Mouse Configurations''':<br />
<br />
MadCatz R.A.T.3:<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Madcatz Mad Catz R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 0 0 0 13 14 15 16 17 18"<br />
EndSection<br />
<br />
== Use extra mouse buttons with Wine/Games ==<br />
<br />
Install {{AUR|evrouter}} and add your user to {{ic|input}} group and relogin to activate changes.<br />
<br />
# gpasswd -a <user> input<br />
<br />
Edit the evrouter config file and change the `eventX` number to the event number the mouse uses with<br />
<br />
$ evrouter --dump /dev/input/event*<br />
<br />
Then assign any hotkeys to any mouse button. Preferably use not often used keystrokes to not interfere with others already used as in the example {{ic|Right Shift + F-key}}.<br />
<br />
{{hc|~/.evrouterrc|2=<br />
# 10<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/277 "XKey/Shift_R+F1"<br />
# 11<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/278 "XKey/Shift_R+F2"<br />
}}<br />
<br />
Start with:<br />
<br />
$ evrouter /dev/input/event*<br />
<br />
Stop with: <br />
<br />
$ evrouter -q && rm -f /tmp/.evrouter*<br />
<br />
==R.A.T. configuration software==<br />
<br />
Saitek/Mad Catz does not provide any official configuration software for Linux.<br />
<br />
There is however open an source project which allows you to configure DPI settings for each and mode [https://github.com/MayeulC/Saitek here].<br />
<br />
It might however require some tweaking for certain R.A.T. mice, such as adding your mouse ID to the list of supported IDs.<br />
<br />
==Mouse Configurations==<br />
<br />
It is recommended that you put those settings in a single file for each model you use, eg. {{ic|/etc/X11/xorg.conf.d/920-rat-mmo7.conf}}.<br />
<br />
=== Mad Catz R.A.T. 5===<br />
<br />
Section "InputClass"<br />
Identifier "Mad Catz R.A.T. 5"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.5 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "Buttons" "21"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 9 8 7 6 10 0 0 0 0 0 0 0 0 0"<br />
Option "ZAxisMapping" "4 5 11 10"<br />
Option "AutoReleaseButtons" "13 14 15"<br />
EndSection<br />
<br />
===Mad Catz M.M.O.7===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap 7"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz R.A.T. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.TE"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" " 1 2 3 4 5 6 7 8 9 10 11 12 0 0 0"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz M.M.O. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap TE"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.TE"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1714"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5" <br />
Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
===Saitek Cyborg R.A.T.3===<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Saitek Cyborg R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
EndSection<br />
<br />
==See also==<br />
<br />
*http://ubuntuforums.org/showthread.php?t=2126385<br />
*http://askubuntu.com/questions/92546/cyborg-r-a-t-3-gaming-mouse-stops-working-after-a-while-and-or-misbehaves</div>Mabalenkhttps://wiki.archlinux.org/index.php?title=Mad_Catz_Mouse&diff=625037Mad Catz Mouse2020-07-13T10:20:50Z<p>Mabalenk: /* The Disable Button Solution */ Changed font formatting.</p>
<hr />
<div>[[Category:Mice]]<br />
[[ja:Mad Catz]]<br />
Mad Catz produces a series of gaming mice, for example the Saitek Cyborg R.A.T.3 Mouse (7 buttons USB wired) or the R.A.T9 (7 buttons USB wireless). The mice do not work properly in X without some reconfiguration. This article explains how to make it work with any desktop manager.<br />
<br />
==Installation==<br />
<br />
No driver installation is required.<br />
The mouse should be detected at boot or whenever it is hot-plugged.<br />
<br />
{{note|On some systems the ''MatchProduct'' string may vary, therefore, you can use the command {{ic|xinput list}} }}<br />
<br />
==Issues==<br />
<br />
After being plugged, the mouse seems to work, but you may experience different issues :<br />
<br />
* You cannot move windows around when grabbing the window's title bar. (happens with [[Openbox]] and other [[Window manager]])<br />
* You cannot click on buttons.<br />
* You cannot get the focus on windows.<br />
* You cannot open menus, even with keyboard shortcuts.<br />
* Display does not refresh (using [[Xcompmgr]])<br />
* Closing certain windows restores functionality until the mouse locks into a new window.<br />
<br />
==The Disable Button Solution==<br />
<br />
The issues are caused by an interaction between R.A.T Mode button and the X Server. To restore proper functionality, the 'Mode' button must be disabled, as follows:<br />
<br />
With root privileges, create and edit the file '''{{ic|/etc/X11/xorg.conf.d/50-vmmouse.conf}}''' (see [[xorg]]).<br />
<br />
Add the following content :<br />
<br />
Section "InputDevice"<br />
Identifier "Mouse0"<br />
Driver "evdev"<br />
Option "Name" "Saitek Cyborg R.A.T.3 Mouse"<br />
Option "Vendor" "06a3"<br />
Option "Product" "0ccc"<br />
Option "Protocol" "auto"<br />
Option "Device" "/dev/input/event4"<br />
Option "Emulate3Buttons" "no"<br />
Option "Buttons" "7"<br />
Option "ZAxisMapping" "4 5"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 0 0 0 0 0 0 0"<br />
Option "Resolution" "3200"<br />
EndSection<br />
<br />
After restarting your X server, the mouse should be fully functional, including the two lateral buttons. You may restart the X server with the following command:<br />
<br />
sudo systemctl restart <display-manager><br />
<br />
where display manager is {{ic|sddm}}, {{ic|lightdm}} or {{ic|gdm3}}. If not, or if you need more information about configuring gaming mice, see [[All Mouse Buttons Working]].<br />
<br />
== RAT7 or RAT9 Partial Fix ==<br />
This is the configuration file that will get your R.A.T. 7 or R.A.T. 9 mouse working properly under linux. <br />
*Does not fix the change-profile button for RAT9, this profile needs more adjustment or just do not push it.<br />
<br />
{{ic|/etc/X11/xorg.conf.d/910-rat.conf}}:<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
# Option "Resolution" "3200"<br />
# Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
You can define different keystrokes applied to each mouse button by defining them in {{ic|~/.xbindkeysrc}} eg.:<br />
<br />
# pressing mouse button 7 sends keystroke: 2<br />
"xvkbd -text 2"<br />
m:0x0 + b:7<br />
# pressing mouse button 8 sends keystroke: Space<br />
"xvkbd -text "\[SPACE]""<br />
m:0x0 + b:8<br />
# pressing mouse button 9 sends keystroke: F8<br />
"xvkbd -text "\[F8]""<br />
m:0x0 + b:9<br />
# pressing mouse button 10 sends keystroke: CursorLeft<br />
"xvkbd -text "\[Left]""<br />
m:0x0 + b:10<br />
# pressing mouse button 11 sends keystroke: Shift+F2<br />
"xvkbd -text "\[Shift]\[F2]""<br />
m:0x0 + b:11<br />
<br />
A very good article on setting up the Mad Catz M.M.O.7 mouse with Linux is written [https://delightlylinux.wordpress.com/2013/07/29/using-the-mad-catz-m-m-o-7-with-linux-mint-and-ubuntu/ here].<br />
<br />
==Manual Button Mapping Fix==<br />
<br />
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.<br />
<br />
First find out the ID and the Name of the mouse :<br />
<br />
xinput list | grep "id"<br />
<br />
In you should see your mouse labeled as "Madcatz Mad Catz R.A.T.3 Mouse" or "Saitek Cyborg R.A.T.3 Mouse". Note the device id number and then input the following command :<br />
<br />
xinput query-state ID<br />
<br />
(Where ID corresponds to the ID number of your mouse)<br />
<br />
Note which 'mode' color is currently active (red/blue/purple) and which button numbers correspond to the current 'mode' by being either '''"up"''' or '''"down"'''. Change the mouse 'mode' and and retype the above command, noting which buttons change state to match the 'mode'.<br />
<br />
Example:<br />
<br />
U = up<br />
D = down<br />
U U U U U D D U U D D D U U <br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
<br />
Where buttons 10, 11, and 12 have been identified as 'mode' buttons, so they can be disabled by with zeros.<br />
<br />
When you have identified which button numbers correspond to the mouse 'modes', you should be able to edit your {{ic|xorg.conf}} file and disable them by inserting a zero in the appropriate point in the button sequence. <br />
<br />
Open in your chosen editor:<br />
<br />
/etc/X11/xorg.conf or<br />
/etc/X11/xorg.conf.d/910-rat-xx.conf<br />
<br />
Create a block that overwrites the mode buttons as listed for your mouse model in chapter '''Mouse Configurations''':<br />
<br />
MadCatz R.A.T.3:<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Madcatz Mad Catz R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 0 0 0 13 14 15 16 17 18"<br />
EndSection<br />
<br />
== Use extra mouse buttons with Wine/Games ==<br />
<br />
Install {{AUR|evrouter}} and add your user to {{ic|input}} group and relogin to activate changes.<br />
<br />
# gpasswd -a <user> input<br />
<br />
Edit the evrouter config file and change the `eventX` number to the event number the mouse uses with<br />
<br />
$ evrouter --dump /dev/input/event*<br />
<br />
Then assign any hotkeys to any mouse button. Preferably use not often used keystrokes to not interfere with others already used as in the example {{ic|Right Shift + F-key}}.<br />
<br />
{{hc|~/.evrouterrc|2=<br />
# 10<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/277 "XKey/Shift_R+F1"<br />
# 11<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/278 "XKey/Shift_R+F2"<br />
}}<br />
<br />
Start with:<br />
<br />
$ evrouter /dev/input/event*<br />
<br />
Stop with: <br />
<br />
$ evrouter -q && rm -f /tmp/.evrouter*<br />
<br />
==R.A.T. configuration software==<br />
<br />
Saitek/Mad Catz does not provide any official configuration software for Linux.<br />
<br />
There is however open an source project which allows you to configure DPI settings for each and mode [https://github.com/MayeulC/Saitek here].<br />
<br />
It might however require some tweaking for certain R.A.T. mice, such as adding your mouse ID to the list of supported IDs.<br />
<br />
==Mouse Configurations==<br />
<br />
It is recommended that you put those settings in a single file for each model you use, eg. {{ic|/etc/X11/xorg.conf.d/920-rat-mmo7.conf}}.<br />
<br />
=== Mad Catz R.A.T. 5===<br />
<br />
Section "InputClass"<br />
Identifier "Mad Catz R.A.T. 5"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.5 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "Buttons" "21"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 9 8 7 6 10 0 0 0 0 0 0 0 0 0"<br />
Option "ZAxisMapping" "4 5 11 10"<br />
Option "AutoReleaseButtons" "13 14 15"<br />
EndSection<br />
<br />
===Mad Catz M.M.O.7===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap 7"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz R.A.T. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.TE"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" " 1 2 3 4 5 6 7 8 9 10 11 12 0 0 0"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz M.M.O. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap TE"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.TE"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1714"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5" <br />
Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
===Saitek Cyborg R.A.T.3===<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Saitek Cyborg R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
EndSection<br />
<br />
==See also==<br />
<br />
*http://ubuntuforums.org/showthread.php?t=2126385<br />
*http://askubuntu.com/questions/92546/cyborg-r-a-t-3-gaming-mouse-stops-working-after-a-while-and-or-misbehaves</div>Mabalenkhttps://wiki.archlinux.org/index.php?title=Mad_Catz_Mouse&diff=625036Mad Catz Mouse2020-07-13T10:18:18Z<p>Mabalenk: /* The Disable Button Solution */ Changed formatting.</p>
<hr />
<div>[[Category:Mice]]<br />
[[ja:Mad Catz]]<br />
Mad Catz produces a series of gaming mice, for example the Saitek Cyborg R.A.T.3 Mouse (7 buttons USB wired) or the R.A.T9 (7 buttons USB wireless). The mice do not work properly in X without some reconfiguration. This article explains how to make it work with any desktop manager.<br />
<br />
==Installation==<br />
<br />
No driver installation is required.<br />
The mouse should be detected at boot or whenever it is hot-plugged.<br />
<br />
{{note|On some systems the ''MatchProduct'' string may vary, therefore, you can use the command {{ic|xinput list}} }}<br />
<br />
==Issues==<br />
<br />
After being plugged, the mouse seems to work, but you may experience different issues :<br />
<br />
* You cannot move windows around when grabbing the window's title bar. (happens with [[Openbox]] and other [[Window manager]])<br />
* You cannot click on buttons.<br />
* You cannot get the focus on windows.<br />
* You cannot open menus, even with keyboard shortcuts.<br />
* Display does not refresh (using [[Xcompmgr]])<br />
* Closing certain windows restores functionality until the mouse locks into a new window.<br />
<br />
==The Disable Button Solution==<br />
<br />
The issues are caused by an interaction between R.A.T Mode button and the X Server. To restore proper functionality, the 'Mode' button must be disabled, as follows:<br />
<br />
With root privileges, create and edit the file '''{{ic|/etc/X11/xorg.conf.d/50-vmmouse.conf}}''' (see [[xorg]]).<br />
<br />
Add the following content :<br />
<br />
Section "InputDevice"<br />
Identifier "Mouse0"<br />
Driver "evdev"<br />
Option "Name" "Saitek Cyborg R.A.T.3 Mouse"<br />
Option "Vendor" "06a3"<br />
Option "Product" "0ccc"<br />
Option "Protocol" "auto"<br />
Option "Device" "/dev/input/event4"<br />
Option "Emulate3Buttons" "no"<br />
Option "Buttons" "7"<br />
Option "ZAxisMapping" "4 5"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 0 0 0 0 0 0 0"<br />
Option "Resolution" "3200"<br />
EndSection<br />
<br />
After restarting your X server, the mouse should be fully functional, including the two lateral buttons. You may restart the X server with the following command:<br />
<br />
sudo systemctl restart <display-manager><br />
<br />
where display manager is '''sddm''', '''lightdm''' or '''gdm3'''. If not, or if you need more information about configuring gaming mice, see [[All Mouse Buttons Working]].<br />
<br />
== RAT7 or RAT9 Partial Fix ==<br />
This is the configuration file that will get your R.A.T. 7 or R.A.T. 9 mouse working properly under linux. <br />
*Does not fix the change-profile button for RAT9, this profile needs more adjustment or just do not push it.<br />
<br />
{{ic|/etc/X11/xorg.conf.d/910-rat.conf}}:<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
# Option "Resolution" "3200"<br />
# Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
You can define different keystrokes applied to each mouse button by defining them in {{ic|~/.xbindkeysrc}} eg.:<br />
<br />
# pressing mouse button 7 sends keystroke: 2<br />
"xvkbd -text 2"<br />
m:0x0 + b:7<br />
# pressing mouse button 8 sends keystroke: Space<br />
"xvkbd -text "\[SPACE]""<br />
m:0x0 + b:8<br />
# pressing mouse button 9 sends keystroke: F8<br />
"xvkbd -text "\[F8]""<br />
m:0x0 + b:9<br />
# pressing mouse button 10 sends keystroke: CursorLeft<br />
"xvkbd -text "\[Left]""<br />
m:0x0 + b:10<br />
# pressing mouse button 11 sends keystroke: Shift+F2<br />
"xvkbd -text "\[Shift]\[F2]""<br />
m:0x0 + b:11<br />
<br />
A very good article on setting up the Mad Catz M.M.O.7 mouse with Linux is written [https://delightlylinux.wordpress.com/2013/07/29/using-the-mad-catz-m-m-o-7-with-linux-mint-and-ubuntu/ here].<br />
<br />
==Manual Button Mapping Fix==<br />
<br />
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.<br />
<br />
First find out the ID and the Name of the mouse :<br />
<br />
xinput list | grep "id"<br />
<br />
In you should see your mouse labeled as "Madcatz Mad Catz R.A.T.3 Mouse" or "Saitek Cyborg R.A.T.3 Mouse". Note the device id number and then input the following command :<br />
<br />
xinput query-state ID<br />
<br />
(Where ID corresponds to the ID number of your mouse)<br />
<br />
Note which 'mode' color is currently active (red/blue/purple) and which button numbers correspond to the current 'mode' by being either '''"up"''' or '''"down"'''. Change the mouse 'mode' and and retype the above command, noting which buttons change state to match the 'mode'.<br />
<br />
Example:<br />
<br />
U = up<br />
D = down<br />
U U U U U D D U U D D D U U <br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
<br />
Where buttons 10, 11, and 12 have been identified as 'mode' buttons, so they can be disabled by with zeros.<br />
<br />
When you have identified which button numbers correspond to the mouse 'modes', you should be able to edit your {{ic|xorg.conf}} file and disable them by inserting a zero in the appropriate point in the button sequence. <br />
<br />
Open in your chosen editor:<br />
<br />
/etc/X11/xorg.conf or<br />
/etc/X11/xorg.conf.d/910-rat-xx.conf<br />
<br />
Create a block that overwrites the mode buttons as listed for your mouse model in chapter '''Mouse Configurations''':<br />
<br />
MadCatz R.A.T.3:<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Madcatz Mad Catz R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 0 0 0 13 14 15 16 17 18"<br />
EndSection<br />
<br />
== Use extra mouse buttons with Wine/Games ==<br />
<br />
Install {{AUR|evrouter}} and add your user to {{ic|input}} group and relogin to activate changes.<br />
<br />
# gpasswd -a <user> input<br />
<br />
Edit the evrouter config file and change the `eventX` number to the event number the mouse uses with<br />
<br />
$ evrouter --dump /dev/input/event*<br />
<br />
Then assign any hotkeys to any mouse button. Preferably use not often used keystrokes to not interfere with others already used as in the example {{ic|Right Shift + F-key}}.<br />
<br />
{{hc|~/.evrouterrc|2=<br />
# 10<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/277 "XKey/Shift_R+F1"<br />
# 11<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/278 "XKey/Shift_R+F2"<br />
}}<br />
<br />
Start with:<br />
<br />
$ evrouter /dev/input/event*<br />
<br />
Stop with: <br />
<br />
$ evrouter -q && rm -f /tmp/.evrouter*<br />
<br />
==R.A.T. configuration software==<br />
<br />
Saitek/Mad Catz does not provide any official configuration software for Linux.<br />
<br />
There is however open an source project which allows you to configure DPI settings for each and mode [https://github.com/MayeulC/Saitek here].<br />
<br />
It might however require some tweaking for certain R.A.T. mice, such as adding your mouse ID to the list of supported IDs.<br />
<br />
==Mouse Configurations==<br />
<br />
It is recommended that you put those settings in a single file for each model you use, eg. {{ic|/etc/X11/xorg.conf.d/920-rat-mmo7.conf}}.<br />
<br />
=== Mad Catz R.A.T. 5===<br />
<br />
Section "InputClass"<br />
Identifier "Mad Catz R.A.T. 5"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.5 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "Buttons" "21"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 9 8 7 6 10 0 0 0 0 0 0 0 0 0"<br />
Option "ZAxisMapping" "4 5 11 10"<br />
Option "AutoReleaseButtons" "13 14 15"<br />
EndSection<br />
<br />
===Mad Catz M.M.O.7===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap 7"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz R.A.T. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.TE"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" " 1 2 3 4 5 6 7 8 9 10 11 12 0 0 0"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz M.M.O. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap TE"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.TE"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1714"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5" <br />
Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
===Saitek Cyborg R.A.T.3===<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Saitek Cyborg R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
EndSection<br />
<br />
==See also==<br />
<br />
*http://ubuntuforums.org/showthread.php?t=2126385<br />
*http://askubuntu.com/questions/92546/cyborg-r-a-t-3-gaming-mouse-stops-working-after-a-while-and-or-misbehaves</div>Mabalenkhttps://wiki.archlinux.org/index.php?title=Mad_Catz_Mouse&diff=625034Mad Catz Mouse2020-07-13T10:17:26Z<p>Mabalenk: /* The Disable Button Solution */ Added information on restarting X server.</p>
<hr />
<div>[[Category:Mice]]<br />
[[ja:Mad Catz]]<br />
Mad Catz produces a series of gaming mice, for example the Saitek Cyborg R.A.T.3 Mouse (7 buttons USB wired) or the R.A.T9 (7 buttons USB wireless). The mice do not work properly in X without some reconfiguration. This article explains how to make it work with any desktop manager.<br />
<br />
==Installation==<br />
<br />
No driver installation is required.<br />
The mouse should be detected at boot or whenever it is hot-plugged.<br />
<br />
{{note|On some systems the ''MatchProduct'' string may vary, therefore, you can use the command {{ic|xinput list}} }}<br />
<br />
==Issues==<br />
<br />
After being plugged, the mouse seems to work, but you may experience different issues :<br />
<br />
* You cannot move windows around when grabbing the window's title bar. (happens with [[Openbox]] and other [[Window manager]])<br />
* You cannot click on buttons.<br />
* You cannot get the focus on windows.<br />
* You cannot open menus, even with keyboard shortcuts.<br />
* Display does not refresh (using [[Xcompmgr]])<br />
* Closing certain windows restores functionality until the mouse locks into a new window.<br />
<br />
==The Disable Button Solution==<br />
<br />
The issues are caused by an interaction between R.A.T Mode button and the X Server. To restore proper functionality, the 'Mode' button must be disabled, as follows:<br />
<br />
With root privileges, create and edit the file '''{{ic|/etc/X11/xorg.conf.d/50-vmmouse.conf}}''' (see [[xorg]]).<br />
<br />
Add the following content :<br />
<br />
Section "InputDevice"<br />
Identifier "Mouse0"<br />
Driver "evdev"<br />
Option "Name" "Saitek Cyborg R.A.T.3 Mouse"<br />
Option "Vendor" "06a3"<br />
Option "Product" "0ccc"<br />
Option "Protocol" "auto"<br />
Option "Device" "/dev/input/event4"<br />
Option "Emulate3Buttons" "no"<br />
Option "Buttons" "7"<br />
Option "ZAxisMapping" "4 5"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 0 0 0 0 0 0 0"<br />
Option "Resolution" "3200"<br />
EndSection<br />
<br />
After restarting your X server, the mouse should be fully functional, including the two lateral buttons. You may restart the X server with the following command:<br />
<br />
sudo systemctl restart <display-manager><br />
<br />
where display manager is `sddm`, `lightdm` or `gdm3`. If not, or if you need more information about configuring gaming mice, see [[All Mouse Buttons Working]].<br />
<br />
== RAT7 or RAT9 Partial Fix ==<br />
This is the configuration file that will get your R.A.T. 7 or R.A.T. 9 mouse working properly under linux. <br />
*Does not fix the change-profile button for RAT9, this profile needs more adjustment or just do not push it.<br />
<br />
{{ic|/etc/X11/xorg.conf.d/910-rat.conf}}:<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
# Option "Resolution" "3200"<br />
# Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
You can define different keystrokes applied to each mouse button by defining them in {{ic|~/.xbindkeysrc}} eg.:<br />
<br />
# pressing mouse button 7 sends keystroke: 2<br />
"xvkbd -text 2"<br />
m:0x0 + b:7<br />
# pressing mouse button 8 sends keystroke: Space<br />
"xvkbd -text "\[SPACE]""<br />
m:0x0 + b:8<br />
# pressing mouse button 9 sends keystroke: F8<br />
"xvkbd -text "\[F8]""<br />
m:0x0 + b:9<br />
# pressing mouse button 10 sends keystroke: CursorLeft<br />
"xvkbd -text "\[Left]""<br />
m:0x0 + b:10<br />
# pressing mouse button 11 sends keystroke: Shift+F2<br />
"xvkbd -text "\[Shift]\[F2]""<br />
m:0x0 + b:11<br />
<br />
A very good article on setting up the Mad Catz M.M.O.7 mouse with Linux is written [https://delightlylinux.wordpress.com/2013/07/29/using-the-mad-catz-m-m-o-7-with-linux-mint-and-ubuntu/ here].<br />
<br />
==Manual Button Mapping Fix==<br />
<br />
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.<br />
<br />
First find out the ID and the Name of the mouse :<br />
<br />
xinput list | grep "id"<br />
<br />
In you should see your mouse labeled as "Madcatz Mad Catz R.A.T.3 Mouse" or "Saitek Cyborg R.A.T.3 Mouse". Note the device id number and then input the following command :<br />
<br />
xinput query-state ID<br />
<br />
(Where ID corresponds to the ID number of your mouse)<br />
<br />
Note which 'mode' color is currently active (red/blue/purple) and which button numbers correspond to the current 'mode' by being either '''"up"''' or '''"down"'''. Change the mouse 'mode' and and retype the above command, noting which buttons change state to match the 'mode'.<br />
<br />
Example:<br />
<br />
U = up<br />
D = down<br />
U U U U U D D U U D D D U U <br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
<br />
Where buttons 10, 11, and 12 have been identified as 'mode' buttons, so they can be disabled by with zeros.<br />
<br />
When you have identified which button numbers correspond to the mouse 'modes', you should be able to edit your {{ic|xorg.conf}} file and disable them by inserting a zero in the appropriate point in the button sequence. <br />
<br />
Open in your chosen editor:<br />
<br />
/etc/X11/xorg.conf or<br />
/etc/X11/xorg.conf.d/910-rat-xx.conf<br />
<br />
Create a block that overwrites the mode buttons as listed for your mouse model in chapter '''Mouse Configurations''':<br />
<br />
MadCatz R.A.T.3:<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Madcatz Mad Catz R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 0 0 0 13 14 15 16 17 18"<br />
EndSection<br />
<br />
== Use extra mouse buttons with Wine/Games ==<br />
<br />
Install {{AUR|evrouter}} and add your user to {{ic|input}} group and relogin to activate changes.<br />
<br />
# gpasswd -a <user> input<br />
<br />
Edit the evrouter config file and change the `eventX` number to the event number the mouse uses with<br />
<br />
$ evrouter --dump /dev/input/event*<br />
<br />
Then assign any hotkeys to any mouse button. Preferably use not often used keystrokes to not interfere with others already used as in the example {{ic|Right Shift + F-key}}.<br />
<br />
{{hc|~/.evrouterrc|2=<br />
# 10<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/277 "XKey/Shift_R+F1"<br />
# 11<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/278 "XKey/Shift_R+F2"<br />
}}<br />
<br />
Start with:<br />
<br />
$ evrouter /dev/input/event*<br />
<br />
Stop with: <br />
<br />
$ evrouter -q && rm -f /tmp/.evrouter*<br />
<br />
==R.A.T. configuration software==<br />
<br />
Saitek/Mad Catz does not provide any official configuration software for Linux.<br />
<br />
There is however open an source project which allows you to configure DPI settings for each and mode [https://github.com/MayeulC/Saitek here].<br />
<br />
It might however require some tweaking for certain R.A.T. mice, such as adding your mouse ID to the list of supported IDs.<br />
<br />
==Mouse Configurations==<br />
<br />
It is recommended that you put those settings in a single file for each model you use, eg. {{ic|/etc/X11/xorg.conf.d/920-rat-mmo7.conf}}.<br />
<br />
=== Mad Catz R.A.T. 5===<br />
<br />
Section "InputClass"<br />
Identifier "Mad Catz R.A.T. 5"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.5 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "Buttons" "21"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 9 8 7 6 10 0 0 0 0 0 0 0 0 0"<br />
Option "ZAxisMapping" "4 5 11 10"<br />
Option "AutoReleaseButtons" "13 14 15"<br />
EndSection<br />
<br />
===Mad Catz M.M.O.7===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap 7"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz R.A.T. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.TE"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" " 1 2 3 4 5 6 7 8 9 10 11 12 0 0 0"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz M.M.O. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap TE"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.TE"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1714"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5" <br />
Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
===Saitek Cyborg R.A.T.3===<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Saitek Cyborg R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
EndSection<br />
<br />
==See also==<br />
<br />
*http://ubuntuforums.org/showthread.php?t=2126385<br />
*http://askubuntu.com/questions/92546/cyborg-r-a-t-3-gaming-mouse-stops-working-after-a-while-and-or-misbehaves</div>Mabalenkhttps://wiki.archlinux.org/index.php?title=Mad_Catz_Mouse&diff=625033Mad Catz Mouse2020-07-13T10:07:56Z<p>Mabalenk: /* The Disable Button Solution */ Corrected a minor typo.</p>
<hr />
<div>[[Category:Mice]]<br />
[[ja:Mad Catz]]<br />
Mad Catz produces a series of gaming mice, for example the Saitek Cyborg R.A.T.3 Mouse (7 buttons USB wired) or the R.A.T9 (7 buttons USB wireless). The mice do not work properly in X without some reconfiguration. This article explains how to make it work with any desktop manager.<br />
<br />
==Installation==<br />
<br />
No driver installation is required.<br />
The mouse should be detected at boot or whenever it is hot-plugged.<br />
<br />
{{note|On some systems the ''MatchProduct'' string may vary, therefore, you can use the command {{ic|xinput list}} }}<br />
<br />
==Issues==<br />
<br />
After being plugged, the mouse seems to work, but you may experience different issues :<br />
<br />
* You cannot move windows around when grabbing the window's title bar. (happens with [[Openbox]] and other [[Window manager]])<br />
* You cannot click on buttons.<br />
* You cannot get the focus on windows.<br />
* You cannot open menus, even with keyboard shortcuts.<br />
* Display does not refresh (using [[Xcompmgr]])<br />
* Closing certain windows restores functionality until the mouse locks into a new window.<br />
<br />
==The Disable Button Solution==<br />
<br />
The issues are caused by an interaction between R.A.T Mode button and the X Server. To restore proper functionality, the 'Mode' button must be disabled, as follows:<br />
<br />
With root privileges, create and edit the file '''{{ic|/etc/X11/xorg.conf.d/50-vmmouse.conf}}''' (see [[xorg]]).<br />
<br />
Add the following content :<br />
<br />
Section "InputDevice"<br />
Identifier "Mouse0"<br />
Driver "evdev"<br />
Option "Name" "Saitek Cyborg R.A.T.3 Mouse"<br />
Option "Vendor" "06a3"<br />
Option "Product" "0ccc"<br />
Option "Protocol" "auto"<br />
Option "Device" "/dev/input/event4"<br />
Option "Emulate3Buttons" "no"<br />
Option "Buttons" "7"<br />
Option "ZAxisMapping" "4 5"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 0 0 0 0 0 0 0"<br />
Option "Resolution" "3200"<br />
EndSection<br />
<br />
After restarting your X server, the mouse should be fully functional, including the two lateral buttons.<br />
If not, or if you need more information about configuring gaming mice, see [[All Mouse Buttons Working]].<br />
<br />
== RAT7 or RAT9 Partial Fix ==<br />
This is the configuration file that will get your R.A.T. 7 or R.A.T. 9 mouse working properly under linux. <br />
*Does not fix the change-profile button for RAT9, this profile needs more adjustment or just do not push it.<br />
<br />
{{ic|/etc/X11/xorg.conf.d/910-rat.conf}}:<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
# Option "Resolution" "3200"<br />
# Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
You can define different keystrokes applied to each mouse button by defining them in {{ic|~/.xbindkeysrc}} eg.:<br />
<br />
# pressing mouse button 7 sends keystroke: 2<br />
"xvkbd -text 2"<br />
m:0x0 + b:7<br />
# pressing mouse button 8 sends keystroke: Space<br />
"xvkbd -text "\[SPACE]""<br />
m:0x0 + b:8<br />
# pressing mouse button 9 sends keystroke: F8<br />
"xvkbd -text "\[F8]""<br />
m:0x0 + b:9<br />
# pressing mouse button 10 sends keystroke: CursorLeft<br />
"xvkbd -text "\[Left]""<br />
m:0x0 + b:10<br />
# pressing mouse button 11 sends keystroke: Shift+F2<br />
"xvkbd -text "\[Shift]\[F2]""<br />
m:0x0 + b:11<br />
<br />
A very good article on setting up the Mad Catz M.M.O.7 mouse with Linux is written [https://delightlylinux.wordpress.com/2013/07/29/using-the-mad-catz-m-m-o-7-with-linux-mint-and-ubuntu/ here].<br />
<br />
==Manual Button Mapping Fix==<br />
<br />
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.<br />
<br />
First find out the ID and the Name of the mouse :<br />
<br />
xinput list | grep "id"<br />
<br />
In you should see your mouse labeled as "Madcatz Mad Catz R.A.T.3 Mouse" or "Saitek Cyborg R.A.T.3 Mouse". Note the device id number and then input the following command :<br />
<br />
xinput query-state ID<br />
<br />
(Where ID corresponds to the ID number of your mouse)<br />
<br />
Note which 'mode' color is currently active (red/blue/purple) and which button numbers correspond to the current 'mode' by being either '''"up"''' or '''"down"'''. Change the mouse 'mode' and and retype the above command, noting which buttons change state to match the 'mode'.<br />
<br />
Example:<br />
<br />
U = up<br />
D = down<br />
U U U U U D D U U D D D U U <br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
<br />
Where buttons 10, 11, and 12 have been identified as 'mode' buttons, so they can be disabled by with zeros.<br />
<br />
When you have identified which button numbers correspond to the mouse 'modes', you should be able to edit your {{ic|xorg.conf}} file and disable them by inserting a zero in the appropriate point in the button sequence. <br />
<br />
Open in your chosen editor:<br />
<br />
/etc/X11/xorg.conf or<br />
/etc/X11/xorg.conf.d/910-rat-xx.conf<br />
<br />
Create a block that overwrites the mode buttons as listed for your mouse model in chapter '''Mouse Configurations''':<br />
<br />
MadCatz R.A.T.3:<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Madcatz Mad Catz R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 0 0 0 13 14 15 16 17 18"<br />
EndSection<br />
<br />
== Use extra mouse buttons with Wine/Games ==<br />
<br />
Install {{AUR|evrouter}} and add your user to {{ic|input}} group and relogin to activate changes.<br />
<br />
# gpasswd -a <user> input<br />
<br />
Edit the evrouter config file and change the `eventX` number to the event number the mouse uses with<br />
<br />
$ evrouter --dump /dev/input/event*<br />
<br />
Then assign any hotkeys to any mouse button. Preferably use not often used keystrokes to not interfere with others already used as in the example {{ic|Right Shift + F-key}}.<br />
<br />
{{hc|~/.evrouterrc|2=<br />
# 10<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/277 "XKey/Shift_R+F1"<br />
# 11<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/278 "XKey/Shift_R+F2"<br />
}}<br />
<br />
Start with:<br />
<br />
$ evrouter /dev/input/event*<br />
<br />
Stop with: <br />
<br />
$ evrouter -q && rm -f /tmp/.evrouter*<br />
<br />
==R.A.T. configuration software==<br />
<br />
Saitek/Mad Catz does not provide any official configuration software for Linux.<br />
<br />
There is however open an source project which allows you to configure DPI settings for each and mode [https://github.com/MayeulC/Saitek here].<br />
<br />
It might however require some tweaking for certain R.A.T. mice, such as adding your mouse ID to the list of supported IDs.<br />
<br />
==Mouse Configurations==<br />
<br />
It is recommended that you put those settings in a single file for each model you use, eg. {{ic|/etc/X11/xorg.conf.d/920-rat-mmo7.conf}}.<br />
<br />
=== Mad Catz R.A.T. 5===<br />
<br />
Section "InputClass"<br />
Identifier "Mad Catz R.A.T. 5"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.5 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "Buttons" "21"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 9 8 7 6 10 0 0 0 0 0 0 0 0 0"<br />
Option "ZAxisMapping" "4 5 11 10"<br />
Option "AutoReleaseButtons" "13 14 15"<br />
EndSection<br />
<br />
===Mad Catz M.M.O.7===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap 7"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz R.A.T. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.TE"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" " 1 2 3 4 5 6 7 8 9 10 11 12 0 0 0"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz M.M.O. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap TE"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.TE"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1714"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5" <br />
Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
===Saitek Cyborg R.A.T.3===<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Saitek Cyborg R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
EndSection<br />
<br />
==See also==<br />
<br />
*http://ubuntuforums.org/showthread.php?t=2126385<br />
*http://askubuntu.com/questions/92546/cyborg-r-a-t-3-gaming-mouse-stops-working-after-a-while-and-or-misbehaves</div>Mabalenkhttps://wiki.archlinux.org/index.php?title=Mad_Catz_Mouse&diff=625032Mad Catz Mouse2020-07-13T10:06:17Z<p>Mabalenk: Corrected a minor typo.</p>
<hr />
<div>[[Category:Mice]]<br />
[[ja:Mad Catz]]<br />
Mad Catz produces a series of gaming mice, for example the Saitek Cyborg R.A.T.3 Mouse (7 buttons USB wired) or the R.A.T9 (7 buttons USB wireless). The mice do not work properly in X without some reconfiguration. This article explains how to make it work with any desktop manager.<br />
<br />
==Installation==<br />
<br />
No driver installation is required.<br />
The mouse should be detected at boot or whenever it is hot-plugged.<br />
<br />
{{note|On some systems the ''MatchProduct'' string may vary, therefore, you can use the command {{ic|xinput list}} }}<br />
<br />
==Issues==<br />
<br />
After being plugged, the mouse seems to work, but you may experience different issues :<br />
<br />
* You cannot move windows around when grabbing the window's title bar. (happens with [[Openbox]] and other [[Window manager]])<br />
* You cannot click on buttons.<br />
* You cannot get the focus on windows.<br />
* You cannot open menus, even with keyboard shortcuts.<br />
* Display does not refresh (using [[Xcompmgr]])<br />
* Closing certain windows restores functionality until the mouse locks into a new window.<br />
<br />
==The Disable Button Solution==<br />
<br />
The issues are caused by an interaction between R.A.T Mode button and the X Server. To restore proper function, the 'Mode' button must be disabled, as follows:<br />
<br />
With root privileges, create and edit the file '''{{ic|/etc/X11/xorg.conf.d/50-vmmouse.conf}}''' (see [[xorg]]).<br />
<br />
Add the following content :<br />
<br />
Section "InputDevice"<br />
Identifier "Mouse0"<br />
Driver "evdev"<br />
Option "Name" "Saitek Cyborg R.A.T.3 Mouse"<br />
Option "Vendor" "06a3"<br />
Option "Product" "0ccc"<br />
Option "Protocol" "auto"<br />
Option "Device" "/dev/input/event4"<br />
Option "Emulate3Buttons" "no"<br />
Option "Buttons" "7"<br />
Option "ZAxisMapping" "4 5"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 0 0 0 0 0 0 0"<br />
Option "Resolution" "3200"<br />
EndSection<br />
<br />
After restarting your X server, the mouse should be fully functional, including the two lateral buttons.<br />
If not, or if you need more information about configuring gaming mice, see [[All Mouse Buttons Working]].<br />
<br />
== RAT7 or RAT9 Partial Fix ==<br />
This is the configuration file that will get your R.A.T. 7 or R.A.T. 9 mouse working properly under linux. <br />
*Does not fix the change-profile button for RAT9, this profile needs more adjustment or just do not push it.<br />
<br />
{{ic|/etc/X11/xorg.conf.d/910-rat.conf}}:<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
# Option "Resolution" "3200"<br />
# Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
You can define different keystrokes applied to each mouse button by defining them in {{ic|~/.xbindkeysrc}} eg.:<br />
<br />
# pressing mouse button 7 sends keystroke: 2<br />
"xvkbd -text 2"<br />
m:0x0 + b:7<br />
# pressing mouse button 8 sends keystroke: Space<br />
"xvkbd -text "\[SPACE]""<br />
m:0x0 + b:8<br />
# pressing mouse button 9 sends keystroke: F8<br />
"xvkbd -text "\[F8]""<br />
m:0x0 + b:9<br />
# pressing mouse button 10 sends keystroke: CursorLeft<br />
"xvkbd -text "\[Left]""<br />
m:0x0 + b:10<br />
# pressing mouse button 11 sends keystroke: Shift+F2<br />
"xvkbd -text "\[Shift]\[F2]""<br />
m:0x0 + b:11<br />
<br />
A very good article on setting up the Mad Catz M.M.O.7 mouse with Linux is written [https://delightlylinux.wordpress.com/2013/07/29/using-the-mad-catz-m-m-o-7-with-linux-mint-and-ubuntu/ here].<br />
<br />
==Manual Button Mapping Fix==<br />
<br />
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.<br />
<br />
First find out the ID and the Name of the mouse :<br />
<br />
xinput list | grep "id"<br />
<br />
In you should see your mouse labeled as "Madcatz Mad Catz R.A.T.3 Mouse" or "Saitek Cyborg R.A.T.3 Mouse". Note the device id number and then input the following command :<br />
<br />
xinput query-state ID<br />
<br />
(Where ID corresponds to the ID number of your mouse)<br />
<br />
Note which 'mode' color is currently active (red/blue/purple) and which button numbers correspond to the current 'mode' by being either '''"up"''' or '''"down"'''. Change the mouse 'mode' and and retype the above command, noting which buttons change state to match the 'mode'.<br />
<br />
Example:<br />
<br />
U = up<br />
D = down<br />
U U U U U D D U U D D D U U <br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
<br />
Where buttons 10, 11, and 12 have been identified as 'mode' buttons, so they can be disabled by with zeros.<br />
<br />
When you have identified which button numbers correspond to the mouse 'modes', you should be able to edit your {{ic|xorg.conf}} file and disable them by inserting a zero in the appropriate point in the button sequence. <br />
<br />
Open in your chosen editor:<br />
<br />
/etc/X11/xorg.conf or<br />
/etc/X11/xorg.conf.d/910-rat-xx.conf<br />
<br />
Create a block that overwrites the mode buttons as listed for your mouse model in chapter '''Mouse Configurations''':<br />
<br />
MadCatz R.A.T.3:<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Madcatz Mad Catz R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 0 0 0 13 14 15 16 17 18"<br />
EndSection<br />
<br />
== Use extra mouse buttons with Wine/Games ==<br />
<br />
Install {{AUR|evrouter}} and add your user to {{ic|input}} group and relogin to activate changes.<br />
<br />
# gpasswd -a <user> input<br />
<br />
Edit the evrouter config file and change the `eventX` number to the event number the mouse uses with<br />
<br />
$ evrouter --dump /dev/input/event*<br />
<br />
Then assign any hotkeys to any mouse button. Preferably use not often used keystrokes to not interfere with others already used as in the example {{ic|Right Shift + F-key}}.<br />
<br />
{{hc|~/.evrouterrc|2=<br />
# 10<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/277 "XKey/Shift_R+F1"<br />
# 11<br />
"Mad Catz Mad Catz M.M.O.7 Mouse" "/dev/input/event9" none key/278 "XKey/Shift_R+F2"<br />
}}<br />
<br />
Start with:<br />
<br />
$ evrouter /dev/input/event*<br />
<br />
Stop with: <br />
<br />
$ evrouter -q && rm -f /tmp/.evrouter*<br />
<br />
==R.A.T. configuration software==<br />
<br />
Saitek/Mad Catz does not provide any official configuration software for Linux.<br />
<br />
There is however open an source project which allows you to configure DPI settings for each and mode [https://github.com/MayeulC/Saitek here].<br />
<br />
It might however require some tweaking for certain R.A.T. mice, such as adding your mouse ID to the list of supported IDs.<br />
<br />
==Mouse Configurations==<br />
<br />
It is recommended that you put those settings in a single file for each model you use, eg. {{ic|/etc/X11/xorg.conf.d/920-rat-mmo7.conf}}.<br />
<br />
=== Mad Catz R.A.T. 5===<br />
<br />
Section "InputClass"<br />
Identifier "Mad Catz R.A.T. 5"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.5 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "Buttons" "21"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 9 8 7 6 10 0 0 0 0 0 0 0 0 0"<br />
Option "ZAxisMapping" "4 5 11 10"<br />
Option "AutoReleaseButtons" "13 14 15"<br />
EndSection<br />
<br />
===Mad Catz M.M.O.7===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap 7"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.7 Mouse|M.M.O.7"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1713"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 0 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz R.A.T. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Mad Catz Mad Catz R.A.T.TE"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" " 1 2 3 4 5 6 7 8 9 10 11 12 0 0 0"<br />
Option "ZAxisMapping" "4 5 6 7"<br />
EndSection<br />
<br />
===Mad Catz M.M.O. TE===<br />
<br />
Section "InputClass"<br />
Identifier "Mouse Remap TE"<br />
MatchProduct "Mad Catz Mad Catz M.M.O.TE"<br />
MatchIsPointer "true"<br />
MatchUSBID "0738:1714"<br />
Driver "evdev"<br />
Option "Buttons" "24"<br />
Option "ButtonMapping" "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24"<br />
Option "AutoReleaseButtons" "20"<br />
Option "ZAxisMapping" "4 5" <br />
Option "ConstantDeceleration" "2"<br />
EndSection<br />
<br />
===Saitek Cyborg R.A.T.3===<br />
<br />
# RAT3 mouse<br />
Section "InputClass"<br />
Identifier "Mouse Remap"<br />
MatchProduct "Saitek Cyborg R.A.T.3 Mouse"<br />
MatchDevicePath "/dev/input/event*"<br />
Option "ButtonMapping" "1 2 3 4 5 0 0 8 9 0 0 0 13 14"<br />
EndSection<br />
<br />
==See also==<br />
<br />
*http://ubuntuforums.org/showthread.php?t=2126385<br />
*http://askubuntu.com/questions/92546/cyborg-r-a-t-3-gaming-mouse-stops-working-after-a-while-and-or-misbehaves</div>Mabalenkhttps://wiki.archlinux.org/index.php?title=Bluetooth_mouse&diff=377503Bluetooth mouse2015-06-05T13:56:32Z<p>Mabalenk: /* Bluez5 instructions */ Added small note for the case of re-inserting the USB Bluetooth dongle into another USB port.</p>
<hr />
<div>[[Category:Mice]]<br />
[[Category:Bluetooth]]<br />
[[cs:Bluetooth Mouse]]<br />
[[ja:Bluetooth マウス]]<br />
[[ru:Bluetooth mouse]]<br />
{{Related articles start}}<br />
{{Related|Bluetooth}}<br />
{{Related|Bluez4}}<br />
{{Related|Mouse polling rate}}<br />
{{Related articles end}}<br />
<br />
This article describes how to set up a [[Bluetooth]] mouse through the command line without relying upon a graphical application.<br />
<br />
== Installation ==<br />
<br />
Install the {{Pkg|bluez}} package which contains the current Linux bluetooth stack (Bluez5). You may also want to install {{Pkg|bluez-utils}} which provides the ''bluetoothctl'' utility. See [[Bluetooth]] for more information.<br />
<br />
If you would prefer to configure bluetooth through the older Bluez4 stack then install the {{Aur|bluez4}} package from the [[AUR]]. Please consult the [[Bluez4]] article for more information.<br />
<br />
{{Warning|Bluez4 has been deprecated. It is strongly recommended that you use Bluez5 instead.}}<br />
<br />
== Bluez5 instructions ==<br />
<br />
{{Tip|Ensure that the bluetooth daemon is started before continuing.}}<br />
<br />
Bluez5 provides the ''bluetoothctl'' utility which provides a simple interface for configuring bluetooth devices.<br />
<br />
The text below is an example of how you can connect a bluetooth mouse using ''bluetoothctl'':<br />
<br />
# bluetoothctl<br />
[bluetooth]# list<br />
Controller <controller mac> BlueZ 5.5 [default]<br />
[bluetooth]# select <controller mac><br />
[bluetooth]# power on<br />
[bluetooth]# scan on<br />
[bluetooth]# agent on<br />
[bluetooth]# devices<br />
Device <mouse mac> Name: Bluetooth Mouse<br />
[bluetooth]# pair <mouse mac><br />
[bluetooth]# trust <mouse mac><br />
[bluetooth]# connect <mouse mac><br />
<br />
In order for the device to start on boot you may have to create a [[udev]] rule. Please see [[Bluetooth#Bluetoothctl]] for more information.<br />
<br />
{{Tip|In case you have a USB Bluetooth dongle and move it to another USB port, you may need to remove the mouse's MAC address ''remove <mouse mac>'' and repeat the entire procedure in ''bluetoothctl'' again.}}<br />
<br />
== Bluez4 instructions ==<br />
<br />
=== Kernel modules ===<br />
<br />
No additional actions are necessary if the bluetooth service is started using systemd. If it does not work try the following command:<br />
<br />
# modprobe -v btusb bluetooth hidp l2cap<br />
<br />
It loads the kernel modules you need, if they were not loaded automatically.<br />
<br />
=== Test ===<br />
<br />
The following command should show your bluetooth adapter:<br />
<br />
{{hc|# hciconfig|<br />
hci0: Type: BR/EDR Bus: USB<br />
BD Address: 00:22:43:E1:82:E0 ACL MTU: 1021:8 SCO MTU: 64:1<br />
UP RUNNING PSCAN <br />
RX bytes:1062273 acl:62061 sco:0 events:778 errors:0<br />
TX bytes:1825 acl:11 sco:0 commands:39 errors:0<br />
}}<br />
<br />
=== Configure bluetooth mouse ===<br />
<br />
The method described here is based in three steps, in this order:<br />
<br />
# Make the PC learn about the bluetooth mouse.<br />
# Grant the mouse permissions to connect.<br />
# Make the mouse learn about the PC.<br />
<br />
=== Search your mouse ===<br />
<br />
First make your mouse discoverable. For example some mouse need to press a button. Then issue the following command:<br />
<br />
{{hc|# hcitool scan|<br />
Scanning ...<br />
00:07:61:F5:5C:3D Logitech Bluetooth Mouse M555b<br />
}}<br />
<br />
Your mouse bluetooth mac address will be similar to {{ic|12:34:56:78:9A:BC}}. You may also find it in the documentation or on the mouse itself.<br />
<br />
=== Connecting the mouse ===<br />
<br />
To scan the device (you may need to use {{ic|su -c}} or {{ic|sudo}}):<br />
<br />
hidd --search<br />
hcitool inq<br />
<br />
To connect the device:<br />
<br />
hidd --connect <bdaddr><br />
<br />
To show your currently connected devices:<br />
<br />
hidd --show<br />
The mouse should show up in this list. If it does not, press the reset button to make it discoverable.<br />
<br />
{{Note|If you have the ipw3945 module loaded (wifi on HP computer) bluetooth would not work.}}<br />
<br />
==== Connecting the mouse at startup ====<br />
<br />
{{Out of date|This section of the article discusses instructions for the [[sysvinit]] init system. [[Sysvinit]] has been replaced by [[Systemd]].}}<br />
Edit {{ic|/etc/conf.d/bluetooth}}:<br />
<br />
# Arguments to hidd<br />
HIDD_OPTIONS="--connect <enter here your bluetooth mouse mac address>"<br />
<br />
and test the new settings:<br />
<br />
/etc/rc.d/bluetooth stop<br />
hidd --killall #(drop mouse connection)<br />
/etc/rc.d/bluetooth start<br />
<br />
{{Note|The above instructions to start the mouse at startup do not work with the now outdated 3.11 bluetooth packages. New versions such as the current (3.32) packages are not affected.}}<br />
<br />
If you are using an older version, then to start the mouse at startup, add:<br />
<br />
hidd --connect <enter here your bluetooth mouse address (No capitals!!!)><br />
<br />
to your {{ic|/etc/rc.local file}}.<br />
<br />
{{Note|You can connect any bluetooth mouse and/or keyboard without any further configuration and without knowing the device address. You can do it by adding the --master and/or --server option in HIDD_OPTIONS depending on your device.}}<br />
<br />
== Troubleshooting ==<br />
<br />
=== Mouse lag ===<br />
<br />
If you experience mouse lag you can try to increase the polling rate. See [[Mouse polling rate]] for more information.<br />
<br />
=== Problems with the USB dongle ===<br />
<br />
If you have trouble with your USB dongle, you may also want to try:<br />
<br />
# modprobe -v rfcomm<br />
<br />
At this point, you should get an hci0 device with:<br />
<br />
# hcitool dev<br />
<br />
Sometimes the device is not active right away. Try starting the interface with:<br />
<br />
# hciconfig hci0 up<br />
<br />
and searching for devices as shown above.</div>Mabalenk