]> git.donarmstrong.com Git - qmk_firmware.git/blob - util/usb_detach/readme.md
Relocate usb_detach to utils (#5121)
[qmk_firmware.git] / util / usb_detach / readme.md
1 # usb_detach
2
3 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.
4 This program can force Linux to give up a device, so that the programming script can reset it.
5
6 ## To compile:
7 ```bash
8 make clean && make
9 ```
10
11 ## To run:
12 1. Use `lsusb` to discover the Bus and Device numbers for your keyboard.
13 2. Run the program: `sudo ./usb_detach /dev/bus/usb/<BUS>/<DEVICE>`.
14 3. Build and program the firmware as normal.