summaryrefslogtreecommitdiffstats
path: root/keyboards/jj40/tools/README.md
diff options
context:
space:
mode:
authorOscillope <jvrosenman@gmail.com>2017-10-14 01:04:36 -0400
committerJack Humbert <jack.humb@gmail.com>2017-10-13 19:04:36 -1000
commitc70b419ec06b22dba869f40c32e23563ee0f620f (patch)
tree6e7db95be8015128dde5669e3568db8074dc5a87 /keyboards/jj40/tools/README.md
parentbccf263cd06a8f854caa79ae511e5c40442de491 (diff)
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.
Diffstat (limited to 'keyboards/jj40/tools/README.md')
-rw-r--r--keyboards/jj40/tools/README.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/keyboards/jj40/tools/README.md b/keyboards/jj40/tools/README.md
new file mode 100644
index 0000000000..081984ed44
--- /dev/null
+++ b/keyboards/jj40/tools/README.md
@@ -0,0 +1,16 @@
+# 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.