From c66aee6b1e92217a27d854ec63bbb3470557288c Mon Sep 17 00:00:00 2001
From: Xtr126 <k.gunetilleke@gmail.com>
Date: Wed, 11 Sep 2024 09:39:11 +0530
Subject: [PATCH] Add "How to disable touchpad" guide

---
 README.md                                     |  1 +
 .../troubleshooting/disable-touchpad.md       | 56 +++++++++++++++++++
 2 files changed, 57 insertions(+)
 create mode 100644 knowledgebase/troubleshooting/disable-touchpad.md

diff --git a/README.md b/README.md
index 251b8b31..2844371c 100644
--- a/README.md
+++ b/README.md
@@ -61,3 +61,4 @@ icon: home
 * [Troubleshooting - Remount as RW](knowledgebase/troubleshooting/remount-system-as-read-write.md)
 * [Troubleshooting - Sound](knowledgebase/troubleshooting/sound-issues.md)
 * [Troubleshooting - WiFi](knowledgebase/troubleshooting/wifi-issues.md)
+* [Troubleshooting - Disable touchpad](knowledgebase/troubleshooting/disable-touchpad.md)
diff --git a/knowledgebase/troubleshooting/disable-touchpad.md b/knowledgebase/troubleshooting/disable-touchpad.md
new file mode 100644
index 00000000..7f630d92
--- /dev/null
+++ b/knowledgebase/troubleshooting/disable-touchpad.md
@@ -0,0 +1,56 @@
+# How to disable touchpad
+Accidental touches due to palm contact with the touchpad can be quite frustrating. Fortunately, the Linux kernel allows you to disable the touchpad or any input device temporarily using sysfs by triggering the uevent. This guide will walk you through the process.
+
+### Step 1: Access a Root Shell
+In order to disable the touchpad, you'll need superuser access. Here's how to get root privileges.
+
+1. **Open KernelSU:**
+   - From the app drawer, locate and open **KernelSU** app.
+   
+2. **Enable Superuser for Termux:**
+   - In the KernelSU interface, find **Termux** in the list of installed apps.
+   - Enable superuser privileges for Termux.
+
+### Step 2: Launch Termux and Switch to Root User
+
+1. **Open Termux:**
+   - Go to the app drawer and launch **Termux**.
+
+2. **Open a root shell:**
+   - In Termux, type `su` and press **Enter** to open a root shell.
+
+### Step 3: Identify the device file of the touchpad and trigger the uevent 
+
+To disable the touchpad, we need to identify which event device corresponds to it. There are two ways to do this:
+
+#### Method 1: Using `getevent -pl`
+1. In the superuser shell, run the command:  
+   ```bash
+   getevent -pl
+   ```
+2. This command will list all input devices attached to the system along with their event IDs. Look for the touchpad device by identifying the descriptions, usually labeled as something like "touchpad" or "Synaptics."
+3. Once you've identified the correct event, note down the event ID (e.g., **eventX**, where X is the number associated with the touchpad).
+
+4. To disable the touchpad, execute the following command:  
+   ```bash
+   echo remove > /sys/class/input/eventX/uevent
+   ```
+   Replace **eventX** with the appropriate number identified earlier.
+
+#### Method 2: Using `getevent -ql`
+
+1. Alternatively, you can use the following command:  
+   ```bash
+   getevent -ql
+   ```
+2. Tap on the touchpad, and the command will show input events associated with that touchpad.
+3. Once you've determined the correct event number (eventX), use the same command to disable it:  
+   ```bash
+   echo remove > /sys/class/input/eventX/uevent
+   ```
+
+
+By following these steps, you can successfully disable your laptop's touchpad on Bliss OS to avoid accidental touches. Should you need to re-enable the touchpad, a reboot of the system will restore its functionality, or you can trigger the uevent to re-add the device if needed:
+   ```bash
+   echo add > /sys/class/input/eventX/uevent
+   ```