aboutsummaryrefslogtreecommitdiffstats
path: root/util/usb_detach/readme.md
diff options
context:
space:
mode:
authorGravatar zvecr <git@zvecr.com>2019-02-18 17:03:44 +0000
committerGravatar Drashna Jaelre <drashna@live.com>2019-02-18 09:03:44 -0800
commit1a6a2a7b75dec3b20311bc6d89923fde3222ba1c (patch)
tree25a7d256f9d78a281a58095822a24a9920c5b73b /util/usb_detach/readme.md
parent545f95c8f49b8714a2fe2d0fa0f849f305cc7ca3 (diff)
downloadqmk_firmware-1a6a2a7b75dec3b20311bc6d89923fde3222ba1c.tar.gz
Relocate usb_detach to utils (#5121)
* Relocate usb_detach to utils * Relocate usb_detach to utils - fix up files after move
Diffstat (limited to 'util/usb_detach/readme.md')
-rw-r--r--util/usb_detach/readme.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/util/usb_detach/readme.md b/util/usb_detach/readme.md
new file mode 100644
index 000000000..ac42944ee
--- /dev/null
+++ b/util/usb_detach/readme.md
@@ -0,0 +1,14 @@
+# usb_detach
+
+When trying to flash on Linux, you may encounter a "Resource Unavailable" error. This means that Linux's HID driver has taken exclusive control of the keyboard, and the program script can't flash it.
+This program can force Linux to give up a device, so that the programming script can reset it.
+
+## To compile:
+```bash
+make clean && make
+```
+
+## To run:
+1. Use `lsusb` to discover the Bus and Device numbers for your keyboard.
+2. Run the program: `sudo ./usb_detach /dev/bus/usb/<BUS>/<DEVICE>`.
+3. Build and program the firmware as normal.