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.