Difference between revisions of "Razer"

From ArchWiki
Jump to: navigation, search
m (Installation)
(Killer Wireless Network Adapter: Added instructions on how to make WiFi stable.)
 
(64 intermediate revisions by 23 users not shown)
Line 1: Line 1:
 
[[Category:Mice]]
 
[[Category:Mice]]
 +
[[Category:Keyboards]]
 
[[bg:Razer]]
 
[[bg:Razer]]
There is currently no official driver for the Razer gaming mice in Linux. However, Michael Buesch has created a tool called '''[http://www.bu3sch.de/cms/index.php/razer-nextgen-config-tool razercfg]''' to configure Razer mice under Linux.
+
[[ja:Razer]]
 +
{{Poor writing|Various style issues, structure lacking}}
 +
There are currently no official drivers for any Razer peripherals in Linux. However, Michael Buesch has created a tool called [http://bues.ch/cms/hacking/razercfg.html razercfg] to configure Razer mice under Linux. There also exist scripts to enable macro keys of Razer keyboards.
  
== Compatibility ==
+
== Razer Peripherals ==
 +
 
 +
=== Compatibility ===
 +
 
 +
''razercfg'' lists the following mice models as stable:
  
'''razercfg''' lists the following mice models as stable:
 
 
* Razer DeathAdder Classic
 
* Razer DeathAdder Classic
 
* Razer DeathAdder 3500 DPI
 
* Razer DeathAdder 3500 DPI
 
* Razer DeathAdder Black Edition
 
* Razer DeathAdder Black Edition
 +
* Razer DeathAdder 2013
 +
* Razer DeathAdder Chroma
 
* Razer Krait
 
* Razer Krait
* Razer Naga
+
* Razer Naga Classic
and the following as stable but missing minor features:
+
* Razer Naga 2012
 +
* Razer Naga 2014
 +
* Razer Naga Hex
 +
* Razer Taipan
 +
 
 +
And the following as stable but missing minor features:
 +
 
 
* Razer Lachesis
 
* Razer Lachesis
 
* Razer Copperhead
 
* Razer Copperhead
 
* Razer Boomslang CE
 
* Razer Boomslang CE
  
== Installation ==
+
=== Installation ===
  
 
Download and install {{AUR|razercfg}} or {{AUR|razercfg-git}} for bleeding edge git releases from the [[AUR]].  
 
Download and install {{AUR|razercfg}} or {{AUR|razercfg-git}} for bleeding edge git releases from the [[AUR]].  
  
After installing with [https://wiki.archlinux.org/index.php/Pacman pacman] add the {{ic|razerd}} daemon
+
You also need to edit your {{ic|/etc/X11/xorg.conf}} file to disable the current mouse settings by commenting them out as in the following example, where also some defaults are set as suggested by the author:
# systemctl enable razerd.service
+
to start up at launch with.
+
  
You also need to edit your {{ic|/etc/xorg.conf}} file to disable the current mouse settings. I just commented them out then set some defaults as suggested by the author:
+
{{hc|/etc/X11/xorg.conf|
{{hc|/etc/xorg.conf|
+
 
  Section "InputDevice"
 
  Section "InputDevice"
 
     Identifier  "Mouse"
 
     Identifier  "Mouse"
Line 31: Line 42:
 
     Option  "Device" "/dev/input/mice"
 
     Option  "Device" "/dev/input/mice"
 
  EndSection}}
 
  EndSection}}
 +
 
It is important to only have {{ic|Mouse}} and not {{ic|Mouse#}} listed in {{ic|xorg.conf}}.
 
It is important to only have {{ic|Mouse}} and not {{ic|Mouse#}} listed in {{ic|xorg.conf}}.
  
=== For Python 3 users ===
+
{{Accuracy|Why reboot?}}
  
If you have python 3 set as your default version then you will have to make a simple change to the source code of the two utilities. You can check by typing the following command {{bc|$ python -V}} If it returns python 2.X then you can skip this section.
+
Restart the computer, then enter:
  
If it returns python 3.X then change the first line of '''both''' files {{ic|/usr/bin/razercfg}} and {{ic|/usr/bin/qrazercfg}} to the following: {{bc|#!/usr/bin/env python2}}
+
# udevadm control --reload-rules
  
=== Final touches ===
+
Then [[start]] the {{ic|razerd}} daemon and possibly enable it.
  
Retart the computer then enter:
+
=== Using the Razer Configuration Tool ===
# udevadm control --reload-rules
+
  
To start the daemon, type:
+
{{Accuracy|Button configuration reported to not work|Talk:Razer#Button configuration in razercfg or qrazercfg}}
# systemctl start razerd.service
+
If you did everything correctly, you shouldn't get errors.
+
  
== Using the Razer Configuration Tool ==
+
There are two commands you can use, one for the command line tool ''razercfg'' or the Qt-based GUI tool ''qrazercfg''.
There are two commands you can use, one for the command line tool {{ic|razercfg}} or the Qt-based GUI tool {{ic|qrazercfg}}.
+
  
 
From the tool you can use the 5 profiles, change the DPI, change mouse frequency, enable and disable the scroll and logo lights and configure the buttons.
 
From the tool you can use the 5 profiles, change the DPI, change mouse frequency, enable and disable the scroll and logo lights and configure the buttons.
  
== Bugs ==
+
If the colors reset on reboot edit the config file directly and test with another reboot:
Everytime I restart, my Razer Lachesis is brought back to 500 DPI. Not that cruicial as I just open the Razer Configuration Tool and set it to 4000 DPI and all is good. I've e-mailed him on this issue and am waiting on a reply.
+
 
 +
{{hc|/etc/razer.conf|
 +
# Configure LEDs
 +
led<nowiki>=</nowiki>1:GlowingLogo:on
 +
led<nowiki>=</nowiki>1:Scrollwheel:on
 +
mode<nowiki>=</nowiki>1:Scrollwheel:static
 +
color<nowiki>=</nowiki>1:Scrollwheel:0000FF
 +
mode<nowiki>=</nowiki>1:GlowingLogo:static
 +
color<nowiki>=</nowiki>1:GlowingLogo:FFFFFF
 +
}}
 +
 
 +
"static" can probably be changed to spectrum or breathing, and mode/color lines can be removed if led is set to "off".
 +
 
 +
== Razer Blade ==
 +
 
 +
Razer Blade is Razer's line of gaming laptops. There is currently a 14" model, and a 17" model. Due to the proprietary SBUI trackpad on the 17" model, it will be extremely difficult to get it to work without extensive USB protocol reversing.
 +
 
 +
=== 2016 version (Razer Blade & Razer Blade Stealth) ===
 +
 
 +
The normal installation process works in general with the exceptions enumerated below.
 +
 
 +
==== Killer Wireless Network Adapter ====
 +
 
 +
The wireless adapter won't work without proprietary firmware. You will require a USB ethernet adapter to do the installation or an ISO with the proprietary driver installed. The wireless adapter presents itself as
 +
 
 +
{{bc|<nowiki>
 +
01:00.0 Network controller: Qualcomm Atheros QCA6174 802.11ac Wireless Network Adapter (rev 32)
 +
</nowiki>}}
 +
 
 +
It is a [http://www.killernetworking.com/product-support/knowledge-base/17-linux/20-killer-wireless-ac-in-linux-ubuntu-debian Killer Wireless-AC 1535] which requires proprietary firmware for the board. The latest 4.4.1 kernel only requires the ''board.bin'' to be overwritten.
 +
 
 +
{{bc|<nowiki>
 +
# wget -O /lib/firmware/ath10k/QCA6174/hw3.0/board.bin http://www.killernetworking.com/support/K1535_Debian/board.bin
 +
</nowiki>}}
 +
 
 +
Or use the [https://github.com/stuartwells4/razer-laptop/tree/master/stealth Installer Script] at your own risk.
 +
 
 +
To improve WiFi stability, go into the BIOS and ENABLE WiFi Firmware loading. This loads the wireless firmware at boot, which prevents the WiFi from failing to initiate at boot.
 +
 
 +
==== Touchpad ====
 +
 
 +
[[Install]] the {{Pkg|xf86-input-libinput}} package. See [[Libinput]] for more information on this driver.
 +
 
 +
Alternatively, if you prefer using the [[Touchpad Synaptics]] driver, [[install]] the {{Pkg|xf86-input-synaptics}} package.
 +
 
 +
==== Graphics Drivers ====
 +
 
 +
The graphics card works OK with the standard intel drivers which you can [[install]] with the {{Pkg|xf86-video-intel}} package.  See [[Intel graphics]] for more information on installation and configuration.
 +
 
 +
Issues with screen flickering seem to be resolved by changing ''AccelMethod'' to ''uxa'' as described in the [[Intel_graphics#SNA_issues|SNA issues]] section.
 +
 
 +
{{bc|<nowiki>
 +
# cat >/etc/X11/xorg.conf.d/20-intel.conf
 +
Section "Device"
 +
  Identifier  "Intel Graphics"
 +
  Driver      "intel"
 +
  Option      "AccelMethod"  "uxa"
 +
  #Option      "AccelMethod"  "sna"
 +
EndSection
 +
</nowiki>}}
 +
 
 +
==== Hybrid graphics ====
 +
 
 +
If the discrete Nvidia GPU is switched off before starting Xorg or Wayland, then the system freezes. The only possible solution is to manually disable/enable the discrete card after starting the graphical session.
 +
However there is a ACPI DSDT fix available which fixes this problem. Check the [https://github.com/m4ng0squ4sh/razer_blade_14_2016_acpi_dsdt repository] for more information.
 +
 
 +
==== Suspend Loop ====
 +
 
 +
Suspending (Close laptop lid) does not seem to work with a basic installation. You can suspend but once the system resumes it suffers from random suspends or the screen going blank for no apparent reason.
 +
 
 +
A temporary fix is to disable the automatic systemd suspend action by chaning the ''HandleLidSwitch'' value in the ''/etc/systemd/logind.conf'' file:
 +
 
 +
{{bc|<nowiki>
 +
HandleLidSwitch=ignore
 +
</nowiki>}}
 +
 
 +
==== Tweaking ====
 +
 
 +
If you are using [[GNOME]], the ''gnome-tweak-tool'' can be used to adjust the window and font scaling. A font scale of ''1.25'' puts the font sizes closer to how they are displayed by default in Windows 10.
 +
 
 +
If you are using an external monitor that is not [[HiDPI]], you can use ''xrandr'' to alter the scaling of the external monitor using the instructions for [[HiDPI#Multiple_displays|Multiple Displays]]. You may have better results though running [[GNOME]] on [[Wayland]]. When installed, clicking the gear icon in [[GDM]] will allow you to select ''Gnome On Wayland'' and will default to that in the future.
 +
 
 +
==== Unresolved Issues ====
 +
 
 +
* the webcam does not seem to work with a basic installation. External webcams work fine. It seems to fail when the resolution is anything but 640x480. {{Pkg|guvcview}} works because it defaults to the resolution. {{Pkg|cheese}} and [https://hangouts.google.com Google Hangouts] do not because they default to the max resolution.
 +
 
 +
=== 2014 version ===
 +
 
 +
==== Problems ====
 +
 
 +
[http://forum.notebookreview.com/razer/751074-2014-razer-blade-14-linux.html Source]
 +
 
 +
* touchpad  (multitouch, although this may be a kernel bug that has since been fixed)
 +
* keys to increase/decrease screen illumination not working
 +
* keys to increase/decrease keyboard illumination not working
 +
 
 +
==== Possible trackpad solution ====
 +
 
 +
[https://bbs.archlinux.org/viewtopic.php?id=173356&p=2 Source]
 +
 
 +
{{bc|
 +
git clone https://github.com/aduggan/hid-rmi.git -b rb14 # and then install it
 +
depmod -a
 +
}}
 +
 
 +
Then [[install]] the {{pkg|synaptics}}{{Broken package link|replaced by {{Pkg|xf86-input-synaptics}}}} package.
 +
 
 +
Feature still not working: pinch to zoom, 3rd mouse button.
 +
 
 +
=== 2013 version ===
 +
 
 +
==== What works ====
 +
 
 +
[https://bbs.archlinux.org/viewtopic.php?id=173356 Source]
 +
 
 +
* Wireless
 +
* Switchable graphics
 +
* Bluetooth
 +
* Keyboard light (HW controlled)
 +
* UEFI boot
 +
* Trackpad (only on Linux 4.0+ '''without''' libinput-based X.Org input driver (xf86-input-libinput) thanks to [http://git.kernel.org/cgit/linux/kernel/git/jikos/hid.git/log/drivers/hid/hid-rmi.c?h=for-3.20/rmi Andrew Duggan's work]).
 +
 
 +
==== Problems ====
 +
 
 +
[http://forum.notebookreview.com/razer/729380-razer-blade-pro-under-linux.html Source]
 +
 
 +
* SwitchBlade UI doesn't work due to lack of drivers.
 +
* <strike>Trackpad scrolling does not work.</strike>
 +
 
 +
==== Possible trackpad solution ====
 +
 
 +
[https://bbs.archlinux.org/viewtopic.php?id=173356&p=2 Source]
 +
 
 +
{{bc|<nowiki>
 +
git clone https://github.com/aduggan/hid-rmi.git -b rb14 # and then install it
 +
depmod -a
 +
</nowiki>}}
 +
 
 +
Then [[install]] the {{pkg|synaptics}}{{Broken package link|replaced by {{Pkg|xf86-input-synaptics}}}} packages.
 +
 
 +
Feature still not working: pinch to zoom, 3rd mouse button
 +
 
 +
 
 +
{{Expansion|The SBUI works as a trackpad, but no linux drivers currently exist. Does it even work for basic trackpad functionality?}}
 +
 
 +
== Razer keyboards ==
 +
There are currently two Python scripts available to enable macro keys under Linux:
 +
 
 +
* {{AUR|blackwidowcontrol}}
 +
** works with regular BlackWidow and BlackWidow 2013
 +
** might work with BlackWidow Ultimate (2013), too
 +
** does not work with BlackWidow (Ultimate) 2016 yet
 +
** uses Python 3
 +
** does not bundle any scripts to create macros (use hot key configuration tool from your desktop environment)
 +
** allows to control the status of the LED
 +
* {{AUR|razer-blackwidow-macro-scripts}}
 +
** works with BlackWidow Ultimate 2013 (unknown whether it works with other versions)
 +
** uses Python 2
 +
** also bundles scripts to create and execute macros
 +
 
 +
== Troubleshooting ==
 +
 
 +
=== Mouse randomly stops working ===
 +
 
 +
{{Note|This is tested on [[ASUS N550JV]] using mouse '''Razer Orochi 2013'''. Laptop probably has faulty charging port and therefore it sometimes directly affects connected mouse USB port and causes similar issues.}}
 +
 
 +
If your razer mouse stops working after some time, however, led flashes or lights up, but reboot and re-plugging does not help, try the following commands.
 +
 
 +
Unload {{ic|ehci_pci}} and {{ic|ehci_hcd}} modules:
 +
 
 +
# rmmod ehci_pci
 +
# rmmod ehci_hcd
 +
 
 +
Disconnect the mouse, wait a few seconds and run the following commands to load modules back:
 +
 
 +
# modprobe ehci_hcd
 +
# modprobe ehci_pci
 +
 
 +
Connect the mouse and it should be working.

Latest revision as of 20:51, 23 August 2016

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements.Tango-edit-clear.png

Reason: Various style issues, structure lacking (Discuss in Talk:Razer#)

There are currently no official drivers for any Razer peripherals in Linux. However, Michael Buesch has created a tool called razercfg to configure Razer mice under Linux. There also exist scripts to enable macro keys of Razer keyboards.

Razer Peripherals

Compatibility

razercfg lists the following mice models as stable:

  • Razer DeathAdder Classic
  • Razer DeathAdder 3500 DPI
  • Razer DeathAdder Black Edition
  • Razer DeathAdder 2013
  • Razer DeathAdder Chroma
  • Razer Krait
  • Razer Naga Classic
  • Razer Naga 2012
  • Razer Naga 2014
  • Razer Naga Hex
  • Razer Taipan

And the following as stable but missing minor features:

  • Razer Lachesis
  • Razer Copperhead
  • Razer Boomslang CE

Installation

Download and install razercfgAUR or razercfg-gitAUR for bleeding edge git releases from the AUR.

You also need to edit your /etc/X11/xorg.conf file to disable the current mouse settings by commenting them out as in the following example, where also some defaults are set as suggested by the author:

/etc/X11/xorg.conf
 Section "InputDevice"
    Identifier  "Mouse"
    Driver  "mouse"
    Option  "Device" "/dev/input/mice"
 EndSection

It is important to only have Mouse and not Mouse# listed in xorg.conf.

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: Why reboot? (Discuss in Talk:Razer#)

Restart the computer, then enter:

# udevadm control --reload-rules

Then start the razerd daemon and possibly enable it.

Using the Razer Configuration Tool

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: Button configuration reported to not work (Discuss in Talk:Razer#Button configuration in razercfg or qrazercfg)

There are two commands you can use, one for the command line tool razercfg or the Qt-based GUI tool qrazercfg.

From the tool you can use the 5 profiles, change the DPI, change mouse frequency, enable and disable the scroll and logo lights and configure the buttons.

If the colors reset on reboot edit the config file directly and test with another reboot:

/etc/razer.conf
# Configure LEDs
led=1:GlowingLogo:on
led=1:Scrollwheel:on
mode=1:Scrollwheel:static
color=1:Scrollwheel:0000FF
mode=1:GlowingLogo:static
color=1:GlowingLogo:FFFFFF

"static" can probably be changed to spectrum or breathing, and mode/color lines can be removed if led is set to "off".

Razer Blade

Razer Blade is Razer's line of gaming laptops. There is currently a 14" model, and a 17" model. Due to the proprietary SBUI trackpad on the 17" model, it will be extremely difficult to get it to work without extensive USB protocol reversing.

2016 version (Razer Blade & Razer Blade Stealth)

The normal installation process works in general with the exceptions enumerated below.

Killer Wireless Network Adapter

The wireless adapter won't work without proprietary firmware. You will require a USB ethernet adapter to do the installation or an ISO with the proprietary driver installed. The wireless adapter presents itself as

01:00.0 Network controller: Qualcomm Atheros QCA6174 802.11ac Wireless Network Adapter (rev 32)

It is a Killer Wireless-AC 1535 which requires proprietary firmware for the board. The latest 4.4.1 kernel only requires the board.bin to be overwritten.

# wget -O /lib/firmware/ath10k/QCA6174/hw3.0/board.bin http://www.killernetworking.com/support/K1535_Debian/board.bin

Or use the Installer Script at your own risk.

To improve WiFi stability, go into the BIOS and ENABLE WiFi Firmware loading. This loads the wireless firmware at boot, which prevents the WiFi from failing to initiate at boot.

Touchpad

Install the xf86-input-libinput package. See Libinput for more information on this driver.

Alternatively, if you prefer using the Touchpad Synaptics driver, install the xf86-input-synaptics package.

Graphics Drivers

The graphics card works OK with the standard intel drivers which you can install with the xf86-video-intel package. See Intel graphics for more information on installation and configuration.

Issues with screen flickering seem to be resolved by changing AccelMethod to uxa as described in the SNA issues section.

# cat >/etc/X11/xorg.conf.d/20-intel.conf 
Section "Device"
  Identifier  "Intel Graphics"
  Driver      "intel"
  Option      "AccelMethod"  "uxa"
  #Option      "AccelMethod"  "sna"
EndSection

Hybrid graphics

If the discrete Nvidia GPU is switched off before starting Xorg or Wayland, then the system freezes. The only possible solution is to manually disable/enable the discrete card after starting the graphical session. However there is a ACPI DSDT fix available which fixes this problem. Check the repository for more information.

Suspend Loop

Suspending (Close laptop lid) does not seem to work with a basic installation. You can suspend but once the system resumes it suffers from random suspends or the screen going blank for no apparent reason.

A temporary fix is to disable the automatic systemd suspend action by chaning the HandleLidSwitch value in the /etc/systemd/logind.conf file:

HandleLidSwitch=ignore

Tweaking

If you are using GNOME, the gnome-tweak-tool can be used to adjust the window and font scaling. A font scale of 1.25 puts the font sizes closer to how they are displayed by default in Windows 10.

If you are using an external monitor that is not HiDPI, you can use xrandr to alter the scaling of the external monitor using the instructions for Multiple Displays. You may have better results though running GNOME on Wayland. When installed, clicking the gear icon in GDM will allow you to select Gnome On Wayland and will default to that in the future.

Unresolved Issues

  • the webcam does not seem to work with a basic installation. External webcams work fine. It seems to fail when the resolution is anything but 640x480. guvcview works because it defaults to the resolution. cheese and Google Hangouts do not because they default to the max resolution.

2014 version

Problems

Source

  • touchpad (multitouch, although this may be a kernel bug that has since been fixed)
  • keys to increase/decrease screen illumination not working
  • keys to increase/decrease keyboard illumination not working

Possible trackpad solution

Source

git clone https://github.com/aduggan/hid-rmi.git -b rb14 # and then install it
depmod -a

Then install the synaptics[broken link: replaced by xf86-input-synaptics] package.

Feature still not working: pinch to zoom, 3rd mouse button.

2013 version

What works

Source

  • Wireless
  • Switchable graphics
  • Bluetooth
  • Keyboard light (HW controlled)
  • UEFI boot
  • Trackpad (only on Linux 4.0+ without libinput-based X.Org input driver (xf86-input-libinput) thanks to Andrew Duggan's work).

Problems

Source

  • SwitchBlade UI doesn't work due to lack of drivers.
  • Trackpad scrolling does not work.

Possible trackpad solution

Source

git clone https://github.com/aduggan/hid-rmi.git -b rb14 # and then install it
depmod -a

Then install the synaptics[broken link: replaced by xf86-input-synaptics] packages.

Feature still not working: pinch to zoom, 3rd mouse button


Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: The SBUI works as a trackpad, but no linux drivers currently exist. Does it even work for basic trackpad functionality? (Discuss in Talk:Razer#)

Razer keyboards

There are currently two Python scripts available to enable macro keys under Linux:

  • blackwidowcontrolAUR
    • works with regular BlackWidow and BlackWidow 2013
    • might work with BlackWidow Ultimate (2013), too
    • does not work with BlackWidow (Ultimate) 2016 yet
    • uses Python 3
    • does not bundle any scripts to create macros (use hot key configuration tool from your desktop environment)
    • allows to control the status of the LED
  • razer-blackwidow-macro-scriptsAUR
    • works with BlackWidow Ultimate 2013 (unknown whether it works with other versions)
    • uses Python 2
    • also bundles scripts to create and execute macros

Troubleshooting

Mouse randomly stops working

Note: This is tested on ASUS N550JV using mouse Razer Orochi 2013. Laptop probably has faulty charging port and therefore it sometimes directly affects connected mouse USB port and causes similar issues.

If your razer mouse stops working after some time, however, led flashes or lights up, but reboot and re-plugging does not help, try the following commands.

Unload ehci_pci and ehci_hcd modules:

# rmmod ehci_pci
# rmmod ehci_hcd

Disconnect the mouse, wait a few seconds and run the following commands to load modules back:

# modprobe ehci_hcd
# modprobe ehci_pci

Connect the mouse and it should be working.