opensteno_qmk/keyboards/jj40/tools/README.md

# JJ40 Tools

## usb_detach.c

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:
```
gcc usb_detach.c -o usb_detach
```

### 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.
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			`# JJ40 Tools`

			`## usb_detach.c`

			`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:`
			```
			`gcc usb_detach.c -o usb_detach`
			```

			`### 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.`