From 7bc1fb4833f1cacd52963927d90b905367b1c0ac Mon Sep 17 00:00:00 2001 From: Felix Date: Sat, 22 Jun 2024 12:47:45 +0200 Subject: [PATCH 1/5] Adding documentation to fix USI Stylus rotation. --- src/docs/installing/post-install.md | 94 ++++++++++++++++++++++++++++- 1 file changed, 93 insertions(+), 1 deletion(-) diff --git a/src/docs/installing/post-install.md b/src/docs/installing/post-install.md index 523a814e..e6cb7acc 100644 --- a/src/docs/installing/post-install.md +++ b/src/docs/installing/post-install.md @@ -61,7 +61,99 @@ If you experience issues in applications such as Parsec, or encounter disruptive 3. Type `grub-mkconfig -o /boot/grub/grub.cfg` or `update-grub` into a terminal and press Enter. Use sudo, su, or doas if necessary. 4. Reboot -## macOS +### Fixing Stylus on Rotation Issue + +Some Chromebooks come with USI styluses. They work fine in the newest versions of KDE Plasma, but they have a rotation issue in GNOME. The issue is that the stylus does not rotate with the screen, so it is only usable in one orientation. To fix this, we have to add an libinput override. + +1. Get the device ID of your stylus by running this script https://github.com/linuxwacom/libwacom/blob/master/tools/show-stylus.py. + ``` bash + tux@fedora:~/Downloads/libwacom/tools$ sudo python ./show-stylus.py + Using "GDIX0000:00 27C6:0E0C Stylus": /dev/input/event5 + Using stylus file(s): /usr/share/libwacom/libwacom.stylus + Tool id 0x1 serial 0x0 in-proximity: False + ^CTerminating + Suggested line for .tablet file: + Styli=isdv4-aes + ``` + In this case, the device ID is `GDIX0000:00 27C6:0E0C Stylus`. + +2. Create a .tablet file for libwacom + ``` bash + sudo mkdir -p /etc/libwacom/ + sudo nano /etc/libwacom/google-{your board name}.tablet + ``` + Add the following content to the file: + ``` bash + [Device] + Name={your device id} + ModelName= + DeviceMatch=i2c:{the hardware id of your stylus lowercased (in this case 27c6:0e0c)} + Class=ISDV4 + Width=9 + Height=5 + IntegratedIn=Display;System + #Styli=isdv4-aes + Styli=@generic-no-eraser + + [Features] + Stylus=true + Touch=false + ``` +3. Create the libinput override + ``` bash + sudo mkdir -p /etc/libinput/ + sudo nano /etc/libinput/local-overrides.quirks + ``` + Add the following content to the file: + ``` bash + [Google Chromebook {your board name} Stylus Digitizer] + MatchUdevType=tablet + MatchDeviceTree=*{your board name}* + MatchBus=i2c + ModelChromebook=1 + AttrPressureRange=1100:1000 + ``` +4. Update the libwacom database and restart the system + ``` bash + sudo libwacom-update-db + reboot + ``` + +#### Example Files for Jinlon +Here are the example files for the Jinlon Chromebook. The device ID is `GDIX0000:00 27C6:0E0C Stylus`. + +`/etc/libwacom/google-jinlon.tablet` +``` bash +[Device] +Name=GDIX0000:00 27C6:0E0C Stylus +ModelName= +DeviceMatch=i2c:27c6:0e0c +Class=ISDV4 +Width=9 +Height=5 +IntegratedIn=Display;System +#Styli=isdv4-aes +Styli=@generic-no-eraser + +[Features] +Stylus=true +Touch=false +``` + +`/etc/libinput/local-overrides.quirks` +``` bash +[Google Chromebook Jinlon Stylus Digitizer] +MatchUdevType=tablet +MatchDeviceTree=*jinlon* +MatchBus=i2c +ModelChromebook=1 +AttrPressureRange=1100:1000 +``` +#### Consider Upstreaming Your Changes to libwacom +Please consider upstreaming your changes to [libwacom](https://github.com/linuxwacom/wacom-hid-descriptors) and [wacom-hid-descriptors](https://github.com/linuxwacom/wacom-hid-descriptors). This will help other users with the same device as you. + + +## macOS - [Remove Verbose](https://dortania.github.io/OpenCore-Post-Install/cosmetic/verbose.html#macos-decluttering) - [OpenCore GUI Setup](https://dortania.github.io/OpenCore-Post-Install/cosmetic/gui.html#setting-up-opencore-s-gui) From 50439a9ab7042d87e2b0162480dbc502f64e869a Mon Sep 17 00:00:00 2001 From: Felix N Date: Sun, 23 Jun 2024 16:05:27 +0200 Subject: [PATCH 2/5] updated title --- src/docs/installing/post-install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/docs/installing/post-install.md b/src/docs/installing/post-install.md index e6cb7acc..7b6ecfe6 100644 --- a/src/docs/installing/post-install.md +++ b/src/docs/installing/post-install.md @@ -61,7 +61,7 @@ If you experience issues in applications such as Parsec, or encounter disruptive 3. Type `grub-mkconfig -o /boot/grub/grub.cfg` or `update-grub` into a terminal and press Enter. Use sudo, su, or doas if necessary. 4. Reboot -### Fixing Stylus on Rotation Issue +### Fixing stylus orientation in Gnome Some Chromebooks come with USI styluses. They work fine in the newest versions of KDE Plasma, but they have a rotation issue in GNOME. The issue is that the stylus does not rotate with the screen, so it is only usable in one orientation. To fix this, we have to add an libinput override. From 0d59507ff877196f83ec56f99243cff1cec47069 Mon Sep 17 00:00:00 2001 From: Felix N Date: Mon, 24 Jun 2024 22:34:58 +0200 Subject: [PATCH 3/5] changed wrong link --- src/docs/installing/post-install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/docs/installing/post-install.md b/src/docs/installing/post-install.md index 7b6ecfe6..0bd249b8 100644 --- a/src/docs/installing/post-install.md +++ b/src/docs/installing/post-install.md @@ -150,7 +150,7 @@ ModelChromebook=1 AttrPressureRange=1100:1000 ``` #### Consider Upstreaming Your Changes to libwacom -Please consider upstreaming your changes to [libwacom](https://github.com/linuxwacom/wacom-hid-descriptors) and [wacom-hid-descriptors](https://github.com/linuxwacom/wacom-hid-descriptors). This will help other users with the same device as you. +Please consider upstreaming your changes to [libwacom](https://github.com/linuxwacom/libwacom) and [wacom-hid-descriptors](https://github.com/linuxwacom/wacom-hid-descriptors). This will help other users with the same device as you. ## macOS From da47538d3e62495308c5b1b769f069a1e6976839 Mon Sep 17 00:00:00 2001 From: "Felix N." Date: Thu, 10 Oct 2024 21:09:33 +0200 Subject: [PATCH 4/5] Mentioning cbmem --- src/docs/installing/post-install.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/src/docs/installing/post-install.md b/src/docs/installing/post-install.md index 0bd249b8..e7e5da77 100644 --- a/src/docs/installing/post-install.md +++ b/src/docs/installing/post-install.md @@ -65,7 +65,9 @@ If you experience issues in applications such as Parsec, or encounter disruptive Some Chromebooks come with USI styluses. They work fine in the newest versions of KDE Plasma, but they have a rotation issue in GNOME. The issue is that the stylus does not rotate with the screen, so it is only usable in one orientation. To fix this, we have to add an libinput override. -1. Get the device ID of your stylus by running this script https://github.com/linuxwacom/libwacom/blob/master/tools/show-stylus.py. +1. Get the device ID of your stylus + This information can either be read from cbmem or libwacom. + To get the ID from libwacom run this script https://github.com/linuxwacom/libwacom/blob/master/tools/show-stylus.py. ``` bash tux@fedora:~/Downloads/libwacom/tools$ sudo python ./show-stylus.py Using "GDIX0000:00 27C6:0E0C Stylus": /dev/input/event5 @@ -77,7 +79,7 @@ Some Chromebooks come with USI styluses. They work fine in the newest versions o ``` In this case, the device ID is `GDIX0000:00 27C6:0E0C Stylus`. -2. Create a .tablet file for libwacom +3. Create a .tablet file for libwacom ``` bash sudo mkdir -p /etc/libwacom/ sudo nano /etc/libwacom/google-{your board name}.tablet @@ -99,7 +101,7 @@ Some Chromebooks come with USI styluses. They work fine in the newest versions o Stylus=true Touch=false ``` -3. Create the libinput override +4. Create the libinput override ``` bash sudo mkdir -p /etc/libinput/ sudo nano /etc/libinput/local-overrides.quirks @@ -113,7 +115,7 @@ Some Chromebooks come with USI styluses. They work fine in the newest versions o ModelChromebook=1 AttrPressureRange=1100:1000 ``` -4. Update the libwacom database and restart the system +5. Update the libwacom database and restart the system ``` bash sudo libwacom-update-db reboot From 7f904188cabec59a58d0a86c27211166b4bcd398 Mon Sep 17 00:00:00 2001 From: "Felix N." Date: Thu, 10 Oct 2024 22:00:31 +0200 Subject: [PATCH 5/5] Fixed numbering mishap --- src/docs/installing/post-install.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/docs/installing/post-install.md b/src/docs/installing/post-install.md index e7e5da77..d8ed1367 100644 --- a/src/docs/installing/post-install.md +++ b/src/docs/installing/post-install.md @@ -79,7 +79,7 @@ Some Chromebooks come with USI styluses. They work fine in the newest versions o ``` In this case, the device ID is `GDIX0000:00 27C6:0E0C Stylus`. -3. Create a .tablet file for libwacom +2. Create a .tablet file for libwacom ``` bash sudo mkdir -p /etc/libwacom/ sudo nano /etc/libwacom/google-{your board name}.tablet @@ -101,7 +101,7 @@ Some Chromebooks come with USI styluses. They work fine in the newest versions o Stylus=true Touch=false ``` -4. Create the libinput override +3. Create the libinput override ``` bash sudo mkdir -p /etc/libinput/ sudo nano /etc/libinput/local-overrides.quirks @@ -115,7 +115,7 @@ Some Chromebooks come with USI styluses. They work fine in the newest versions o ModelChromebook=1 AttrPressureRange=1100:1000 ``` -5. Update the libwacom database and restart the system +4. Update the libwacom database and restart the system ``` bash sudo libwacom-update-db reboot