add uhci_hcd bug to README.md

[evhz] / README.md

diff --git a/README.md b/README.md
index 328c4e5815318d8ca225c8957d5c7f9940b5451b..780a9adb2c65699d57173c7c931ef0d3ea1c612a 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,18 +1,24 @@
-evhz
-====
+# evhz
 
-Display the current mouse refresh rate under evdev linux system.
+Display the current mouse refresh rate under linux with evdev
 
-It is sufficient to simply download evhz.c vs cloning the repo.
+For information about polling rate, see https://wiki.archlinux.org/index.php/Mouse_Polling_Rate
 
-To compile and run:
+The program is just evhz.c. Compile and run:
 
-gcc -o evhz evhz.c
-
-sudo ./evhz
+    gcc -o evhz evhz.c
+    sudo ./evhz
 
 Nonverbose mode = -n
 
-Bugs, patches, requests, etc. are welcome.
+There exists a kernel bug for USB ports which use the uhci_hcd driver,
+where a 1000 hz mouse will only read at 500hz, causing jittering:
+https://bugzilla.kernel.org/show_bug.cgi?id=60586. A workaround is to
+use USB ports that use the ehci-pci driver.
+
+Maintainer: Ian Kelling <ian@iankelling.org>
+
+Bugs, patches, requests, feedback are welcome.
 
-Last tested 7/2014 on Fedora 20. Still working great. 
\ No newline at end of file
+Last tested 7/2016 on Debian testing. Still working great after several
+years.