]> code.bitgloo.com Git - clyne/logitech-g710-linux-driver.git/summary
 
descriptionModified Logitech G710 Linux driver for extended functionality
ownerClyne Sullivan
last changeMon, 28 Dec 2015 02:11:21 +0000 (21:11 -0500)

Logitech G710+ Keyboard Driver

The Logitech G710+ mechanical keyboard is a great piece of hardware. Unfortunately, there is no support in the kernel for the additional features of the keyboard.

This kernel driver allows the keys M1-MR and G1-G6 to be used.

Instalation Instructions

First you have to compile the driver:

make

if the compilation was successfull, you will now have a new kernel module in the directory.

The next step is to install the kernel module:

sudo make install
sudo depmod -a

At this point the generic driver will still take control. The simple fix for that issue is to copy the 90-logitech-g710-plus.rules file from the misc folder to /etc/udev/rules.d/:

sudo cp misc/90-logitech-g710-plus.rules /etc/udev/rules.d/

Finally, if you do not receive any events in your environment, it might be necessary to use the modmap provided in the misc folder:

xmodmap misc/.Xmodmap

Usage

Use the key shortcut utilities provided by your DE to make use of the additional buttons.

API

The driver also exposes a way to set the keyboard backlight intensity. That is done by writing either:

/sys/bus/hid/devices/0003:046D:C24D.XXXX/logitech-g710/led_macro
/sys/bus/hid/devices/0003:046D:C24D.XXXX/logitech-g710/led_keys

where XXXX is varies (e.g. 0008)

The led_macro file expects a single number which is a bitmask of the first 4 bits. Each bit corresponds to a button. E.g. if you want to light up M1 and M3, you must write the bit pattern 0101, which corresponds to 5 in decimal:

echo -n "5" > /sys/bus/hid/devices/0003:046D:C24D.XXXX/logitech-g710/led_macro

Writing the led_keys is a bit more involved. The file expects a single digit which is constructed in the following way:

value= wasd << 4 | key

where: 
   wasd - WASD light intensity
   key - Other key light intensity

Only values from 0-4 accepted
shortlog
2015-12-28 Clyne Sullivanchanged M key function master
2015-01-09 WattosMerge pull request #16 from ireyon/master
2015-01-02 Philip RebohleReplaced strict_strtoul calls with kstrtoul calls
2014-11-20 WattosMerge pull request #15 from Lompik/master
2014-11-20 OrionURemove DEVICE_ATTR commented lines
2014-11-19 OrionUChange change S_IRUGO | S_IWUGO to 0660
2013-11-24 WattosMerge pull request #10 from felixrg/hid_quirk
2013-11-24 Felix RueeggUse HID_QUIRK_NOGET to prevent wrong first HID report
2013-10-31 WattosMerge pull request #7 from felixrg/bugfix
2013-10-06 Felix RueeggFix to ignore first hid report with recent kernel versi...
2013-10-06 Felix RueeggRemove sysfs attributes when removing driver to prevent...
2013-07-05 WattosMerge pull request #6 from papricasix/master
2013-07-05 Michael Dudek* Kernel 3.10 compatibility enabled. Some API has been...
2013-05-13 Filip Wieladekadded dkms.conf for automatic rebuilding of kernel...
2013-05-12 Filip Wieladekuse GPL2
2013-05-12 Filip WieladekMerge branch 'master' of github.com:Wattos/logitech...
...
heads
9 years ago master