GitXplorerGitXplorer
l

hid-asus-dkms

public
68 stars
10 forks
2 issues

Commits

List of commits on branch master.
Verified
fbee3136048e78800720fe29d1532295f8718afd

Merge pull request #55 from drvlabo/mod_build_fix

llarixer committed 6 years ago
Unverified
e6922db82f3ed099faff9ead65c3229116dd7884

modified to build later version kernel

ddrvlabo committed 6 years ago
Unverified
af1d6247d0ee30c8bc0c8c294aea955fd6115278

Specify that this driver is only for FTE100*

llarixer committed 8 years ago
Unverified
545f9ebf500d8b59f12d42de23c91bfa7827c010

Update README.md

rredmcg committed 8 years ago
Unverified
f5d63258a33ef6897eebb3253482f75dd49fd355

Update README.md

rredmcg committed 8 years ago
Unverified
596f7f4892a7d94bc28bf01872b5c42c06e2aa17

Update README.md

rredmcg committed 8 years ago

README

The README file for this repository.

ASUS HID FTE100* DKMS driver

Note that this DKMS driver is obsolete if you are running Kernel version 4.10 or later. It has been included in the base version of this Kernel.

This driver has also been backported to Yaketty (Ubuntu Kernel version 4.8) - so you will not need this DKMS driver if you are running Ubuntu 16.04.2 LTS with Kernel version 4.8 or later.

If you are running Ubuntu 16.04.2 LTS with an earlier Kernel version and would like to upgrade - please see the information here.

Prerequisites

  1. Ensure secure boot is not enabled (or you have an acceptable alterantive in place). With end-to-end secure boot enabled, after installing this DKMS driver you will get this error message in kernel log:

    modprobe: ERROR: could not insert 'hid_asus': Required key not available

    You won't be able to run third-party (aka 'out of tree') kernel modules with secure boot. This is because for secure boot to work all the modules have to be signed - and given our module is third party it hasn't been signed.

    If you want to use this module you'll need to disable secure boot.

  2. Ensure dkms package is installed.

  3. Ensure Linux kernel headers installed for your kernel version.

Getting Started

  1. Clone source code locally.
git clone https://github.com/vlasenko/hid-asus-dkms.git
cd hid-asus-dkms
  1. Install DKMS driver and load kernel module into memory.
./dkms-add.sh

Check that multi-touch gestures work after executing this command and after reboot as well.

Submitting issues

Please use GitHub issue tracker for submitting issues with DKMS driver:

https://github.com/vlasenko/hid-asus-dkms/issues

This is the most convenient place for us to provide support on this project.

Please provide in your issue the output for the following three commands (preferably ran immediately after a completed reboot):

dmesg | grep hid
xinput
xinput list-props "Asus TouchPad"

This will allow us to confirm you have the correct hardware and that your X Input Drivers are configured correctly.

If the driver has installed correctly but is showing some edge case issues (like random movements) - you may need to configure your X Input Driver to ignore these edge cases. See this for comments about how this can be acheived with the Synaptics driver.

Updating to the latest driver version

  1. Pull latest source code from repository.
cd hid-asus-dkms
git pull
  1. Reinstall DKMS driver.
./dkms-add.sh

This will install DKMS driver into the system and reloads it immediately.

Development Scripts

  1. Script to clean compile the module from source without installing to dkms
./dev-run.sh
  1. Script to bind touchpad to this DKMS driver, until reboot
./dev-attach.sh
  1. Script to restore back touchpad handling by hid_generic driver, until reboot
./dev-restore.sh