perixx1800keyboard/README.md

75 lines
2.8 KiB
Markdown

# Linux Microdia Keyboard Chipset Driver #
For Chipset `0x0c45`:`0x7603`
The kernel reports the chipset as `Microdia`
Written for the Perixx PX-1800 USB Keyboard: [Perixx PX-1800 Keyboard](http://www.perixx.com/en/service/Perixx_Manual/GAMING/PX-1800.pdf)
Original base: swoogan.blogspot.de/2014/09/azio-l70-keyboard-linux-driver.html
> NOTE: Makefile and instructions are only tested on Ubuntu, however they are known to work on Debian, Arch, Fedora, and Manjaro.
Reportedy supports the following keyboards as well:
* SL-6432-BK - Speedlink LUCIDIS Comfort Illuminated Keyboard
* COUGAR 200K Scissor Gaming Keyboard
* GAMDIAS USB Keyboard (unspecified model but will report as Microdia chipset)
* Avazz USB Keyboard (unspecified model but will report as Microdia chipset)
* Perixx P1800
* Modecom MC800-Volcano
# Installation ##
## DKMS ##
# debian-based:
sudo apt-get install mercurial build-essential linux-headers-generic dkms
# fedora:
sudo dnf install kernel-devel kernel-headers
sudo dnf groupinstall "Development Tools" "Development Libraries"
hg clone https://bitbucket.org/Swoogan/aziokbd
cd aziokbd
sudo ./install.sh dkms
## Manual Install ##
sudo apt-get install mercurial build-essential linux-headers-generic
hg clone https://bitbucket.org/Swoogan/aziokbd
cd aziokbd
sudo ./install.sh
# Blacklisting #
**NOTE: install.sh attempts to blacklist the driver for you. You shouldn't need to do anything manually. These instructions are to explain the process, in the event something goes wrong.**
You need to blacklist the device from the generic USB hid driver in order for the aziokbd driver to control it.
## Kernel Module ##
If the USB hid driver is compiled as a kernel module you will need to create a quirks file and blacklist it there.
You can determine if the driver is a module by running the following:
lsmod | grep usbhid
If `grep` finds something, it means that the driver is a module.
Create a file called `/etc/modprobe.d/usbhid.conf` and add the following to it:
options usbhid quirks=0x0c45:0x7603:0x0004
If you find that the generic USB driver is still taking the device, try changing the `0x0004` to a `0x0007`.
## Compiled into Kernel ##
If the generic USB hid driver is compiled into the kernel, then the driver is not loaded as a module and setting the option via `modprobe` will not work. In this case you must pass the option to the driver via the grub boot loader.
Create a new file in `/etc/default/grub.d/`. For example, you might call it `aziokbd.conf`. (If your grub package doesn't have this directory, just modify the generic `/etc/default/grub` configuration file):
GRUB_CMDLINE_LINUX_DEFAULT='usbhid.quirks=0x0c45:0x7603:0x4'
Then run `sudo update-grub` and reboot.
Again, if you find that `0x4` doesn't work, try `0x7`.