summaryrefslogtreecommitdiff
path: root/keyboard/README.md
diff options
context:
space:
mode:
authorYuval Adam <yuval@y3xz.com>2016-03-26 12:09:21 +0300
committerYuval Adam <yuval@y3xz.com>2016-03-26 12:09:21 +0300
commit77a124b725db68815c514bf1a2e4506c5c2a83a6 (patch)
tree783250ef773023a1aa728b5fcc649e347046f05f /keyboard/README.md
parent6b948aa9b2b48251940db5ebfc33877a887d7fb7 (diff)
Copy usb/ files to keyboard/
Diffstat (limited to 'keyboard/README.md')
-rw-r--r--keyboard/README.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/keyboard/README.md b/keyboard/README.md
new file mode 100644
index 0000000..b2aeec5
--- /dev/null
+++ b/keyboard/README.md
@@ -0,0 +1,26 @@
+# Keyboard
+
+A USB HID keyboard example, heavily based on http://codeandlife.com/2012/06/18/usb-hid-keyboard-with-v-usb/
+
+## Usage
+
+Build the program and flash it as usual to the digispark.
+
+```bash
+$ make clean && make
+$ micronucleus usb.hex
+```
+
+After the program loads, you should see a new USB device:
+
+```bash
+$ lsusb
+Bus 111 Device 222: ID 16c0:05dc Van Ooijen Technische Informatica shared ID for use with libusb
+```
+
+You can now flip the LED by calling the test program, requires root privilege or proper udev rules:
+
+```bash
+$ ./usbtest on
+$ ./usbtest off
+```