opensteno_qmk/util/usb_detach/readme.md

# 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.
Relocate usb_detach to utils (#5121) * Relocate usb_detach to utils * Relocate usb_detach to utils - fix up files after move 2019-02-18 17:03:44 +00:00			`# usb_detach`
Add multiple layout support and Linux flash utility to JJ40 (#1837) * Adds support for multiple layouts. Adds custom keymap for "offset" layout. * Adds a tool to help detach the keyboard from the Linux HID driver before programming. * Adds a tool to help detach the keyboard from the Linux HID driver before programming. 2017-10-14 05:04:36 +00:00
			`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.`

Relocate usb_detach to utils (#5121) * Relocate usb_detach to utils * Relocate usb_detach to utils - fix up files after move 2019-02-18 17:03:44 +00:00			`## To compile:`
			```bash
			`make clean && make`
Add multiple layout support and Linux flash utility to JJ40 (#1837) * Adds support for multiple layouts. Adds custom keymap for "offset" layout. * Adds a tool to help detach the keyboard from the Linux HID driver before programming. * Adds a tool to help detach the keyboard from the Linux HID driver before programming. 2017-10-14 05:04:36 +00:00			```

Relocate usb_detach to utils (#5121) * Relocate usb_detach to utils * Relocate usb_detach to utils - fix up files after move 2019-02-18 17:03:44 +00:00			`## To run:`
Add multiple layout support and Linux flash utility to JJ40 (#1837) * Adds support for multiple layouts. Adds custom keymap for "offset" layout. * Adds a tool to help detach the keyboard from the Linux HID driver before programming. * Adds a tool to help detach the keyboard from the Linux HID driver before programming. 2017-10-14 05:04:36 +00:00			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.`