Commit 9ff92182 authored by Adya's avatar Adya

Updated README.md (ease to read)

parent f124513d
......@@ -37,17 +37,25 @@ The reason behind this is very simple: the **mainline driver code does not check
Open a terminal and follow these steps:
1. **Clone** this repository:
`$ git clone https://gitlab.com/AdyaAdya/goodix-touchscreen-linux-driver`
```
$ git clone https://gitlab.com/AdyaAdya/goodix-touchscreen-linux-driver
```
2. **Move** into the folder:
`$ cd goodix-touchscreen-linux-driver`
```
$ cd goodix-touchscreen-linux-driver
```
3. **Build** the driver:
`$ make`
```
$ make
```
4. If no error occurs, **test** the driver (you need to have root privileges):
`# rmmod goodix`
`# insmod goodix.ko`
```
# rmmod goodix
# insmod goodix.ko
```
If the touchscreen and the pen work as you want them to, install the driver on your machine by following the steps below.
......@@ -56,27 +64,35 @@ If the touchscreen and the pen work as you want them to, install the driver on y
Assuming you are in the cloned directory and you already successfully built the driver, follow these steps:
1. **Compress** into xz format the driver:
`$ xz goodix.ko`
```
$ xz goodix.ko
```
2. **Replace** the current driver with the new one (root privileges required):
`# mv goodix.ko.xz /lib/modules/$(uname -r)/kernel/drivers/input/touchscreen/goodix.ko.xz`
```
# mv goodix.ko.xz /lib/modules/$(uname -r)/kernel/drivers/input/touchscreen/goodix.ko.xz
```
It should be up and working now, even after reboot.
#### Troubleshooting
If you are having trouble getting the driver to work, you might want to check the results of some of the following commands:
`$ dmesg | grep -i goodix`
`$ cat /proc/bus/input/devices | grep -B 1 -A 8 -i goodix`
`# libinput list-devices | grep -A 17 -i goodix`
`# libinput debug-events`
`$ xinput list`
```
$ dmesg | grep -i goodix
$ cat /proc/bus/input/devices | grep -B 1 -A 8 -i goodix
# libinput list-devices | grep -A 17 -i goodix
# libinput debug-events
$ xinput list
```
- `eventX - Goodix Active Stylus Pen: libinput bug: missing tablet capabilities: resolution. Ignoring this device` (from the output of `# libinput debug-events`)
- **Reason**: This error is very likely to occur, if you are using `libinput` of course. It indicates that `udev` misses some resolution information for the pen device and thus cannot present it as a Tablet device.
- **Solution**: **Update the `hwdb`** (HardWare DataBase) of your machine to add the missing resolution information by following these steps:
1. **Locate** the `evdev.hwdb` file (should be in `/usr/lib/udev/hwdb.d/` or `/etc/udev/hwdb.d/`):
`# find / -type f -name *-evdev.hwdb`
```
# find / -type f -name *-evdev.hwdb
```
2. **Edit** the file by appending the following (replace `2736` by the your horizontal resolution in pixels and `1824` by your vertical resolution, if necessary):
```
# Goodix Touchscreen and Pen
......@@ -87,9 +103,13 @@ If you are having trouble getting the driver to work, you might want to check th
EVDEV_ABS_36=::1824
```
3. **Update** the hwdb:
`# systemd-hwdb update`
```
# systemd-hwdb update
```
4. **Apply** the changes:
`# udevadm trigger`
```
# udevadm trigger
```
5. **Reload** the driver (see step 4 of `Build the driver` section) (alternatively, you can reboot if you followed the steps of the `Install the driver` section)
#### Credits
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment