1
0
mirror of https://github.com/MatMoul/g810-led.git synced 2024-12-23 09:16:11 +00:00
g810-led/INSTALL.md
Lars Kiesow e13deb8460 Fedora Packages
I took the liberty to create a Fedora Copr repository for this project
to make this easier to install. I've added the installation instructions
to `INSTALL.md` in case you want to add it there.

> https://copr.fedorainfracloud.org/coprs/lkiesow/g810-led/
2018-10-31 19:20:09 +01:00

2.1 KiB

Installation :

Build dependencies :

  • git
  • g++
  • make

Dependencies :

  • hidapi or libusb

hidapi vs libusb :

hidapi is a newer implementation but needs more testing.
hidapi is more responsive than libusb (~20ms vs ~150ms).
hidapi seems to not work on CentOS, writing to hidraw is not allowed.
hidapi is recommended but if you encounter a problem on your system, switch to libusb.

Installation using repos :

ArchLinux (aur) :
yaourt -S g810-led-git # with yaourt
pacaur -S g810-led-git # with pacaur
Fedora (copr) :
sudo dnf copr enable lkiesow/g810-led # Enable Copr repository
sudo dnf install g810-led

Installation of dependencies :

ArchLinux :
sudo pacman -S git gcc make hidapi # for hidapi
sudo pacman -S git gcc make libusb # for libusb
Debian :
sudo apt-get install git g++ make libhidapi-dev # for hidapi
sudo apt-get install git g++ make libusb-1.0-0-dev # for libusb
Fedora :
sudo dnf install git make gcc-c++ hidapi-devel # for hidapi
sudo dnf install git make gcc-c++ libusbx-devel # for libusb

Installation :

git clone https://github.com/MatMoul/g810-led.git
cd g810-led
make bin # for hidapi
make bin LIB=libusb # for libusb
sudo make install

Installation of the library (For developers) :

make lib # for hidapi
make lib LIB=libusb # for libusb
sudo make install-lib to install the libg810-led library.
sudo make install-dev to install the libg810-led library and headers for development.

Update :

Same as install, but your profile and reboot files are preserved.

Uninstall :

sudo make uninstall

Boot profiles :

On boot, the keyboard is set with the udev file /etc/udev/rules.d/g810-led.rules
This file launches the profile stored in /etc/g810-led/profile
To prevent your keyboard flashing 3 times when you reboot use the systemd unit (g810-led-reboot).

Samples can be found in /etc/g810-led/samples.