summaryrefslogtreecommitdiffstats
path: root/docs/faq_debug.md
diff options
context:
space:
mode:
authorindivid-divided <75159519+individ-divided@users.noreply.github.com>2021-03-03 22:31:41 +0100
committerGitHub <noreply@github.com>2021-03-03 13:31:41 -0800
commit4c3090ace922c06d00df12f7fc5d0f2d0f194fae (patch)
tree9a23248a6e2e0b8b4723a2536159802265f440d4 /docs/faq_debug.md
parentfb3777f085fb0ba0510e4217df58f00f6ebd5a01 (diff)
Documentation changes SPLIT_USB_DETECT and hid_listen udev rules (#11665)
Co-authored-by: David Grundberg <david@quartz>
Diffstat (limited to 'docs/faq_debug.md')
-rw-r--r--docs/faq_debug.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/faq_debug.md b/docs/faq_debug.md
index 872b1688ed..13a649bfa2 100644
--- a/docs/faq_debug.md
+++ b/docs/faq_debug.md
@@ -109,6 +109,19 @@ If you can't get this 'Listening:' message try building with `CONSOLE_ENABLE=yes
You may need privileges to access the device an OS like Linux. Try `sudo hid_listen`.
+On many Linux distros you can avoid having to run hid_listen as root
+by creating a file called `/etc/udev/rules.d/70-hid-listen.rules` with
+the following content:
+
+```
+SUBSYSTEM=="hidraw", ATTRS{idVendor}=="abcd", ATTRS{idProduct}=="def1", TAG+="uaccess", RUN{builtin}+="uaccess"
+```
+
+Replace abcd and def1 with your keyboard's vendor and product id,
+letters must be lowercase. The `RUN{builtin}+="uaccess"` part is only
+needed for older distros.
+
+
## Can't Get Message on Console
Check:
- *hid_listen* finds your device. See above.