aboutsummaryrefslogtreecommitdiffstats
path: root/keyboards/thevankeyboards/bananasplit/keymaps/rask/README.md
diff options
context:
space:
mode:
authorMechMerlin <30334081+mechmerlin@users.noreply.github.com>2018-09-13 09:40:43 -0700
committerDrashna Jaelre <drashna@live.com>2018-09-13 09:40:43 -0700
commitce122c4981c71d33a85db94c787d5ec7a823acc6 (patch)
tree82693003e0e6f4191bd34362025e5ed5bb6ee9db /keyboards/thevankeyboards/bananasplit/keymaps/rask/README.md
parentcd3518b802071a915ff11659a32bf0a124687ea3 (diff)
downloadfirmware-ce122c4981c71d33a85db94c787d5ec7a823acc6.tar.gz
firmware-ce122c4981c71d33a85db94c787d5ec7a823acc6.tar.bz2
firmware-ce122c4981c71d33a85db94c787d5ec7a823acc6.zip
Keyboard: Shuffle keyboards into thevankeyboards directory (#3895)
* move tv44 to thevankeyboards directory * move bananasplit to thevankeyboards * move roadkit to thevankeyboards directory * add a basic readme * update readmes to correct the make instructions and add more help text * rename tv44 to minivan as per Jack's suggestions * update readme * rename tv44 to minivan * update tv44 to minivan * change includes for tv44 to minivan * remove extra includes
Diffstat (limited to 'keyboards/thevankeyboards/bananasplit/keymaps/rask/README.md')
-rw-r--r--keyboards/thevankeyboards/bananasplit/keymaps/rask/README.md53
1 files changed, 53 insertions, 0 deletions
diff --git a/keyboards/thevankeyboards/bananasplit/keymaps/rask/README.md b/keyboards/thevankeyboards/bananasplit/keymaps/rask/README.md
new file mode 100644
index 000000000..ec19d3935
--- /dev/null
+++ b/keyboards/thevankeyboards/bananasplit/keymaps/rask/README.md
@@ -0,0 +1,53 @@
+# rask's BananaSplit60
+
+![BS60 layout](http://i.imgur.com/Q7so1py.png)
+
+## Notes
+
+### Layers
+
+Base layer is a regular HHKBish ANSI layer. Toggling the
+alternate base layer (Fn3) makes it simpler to play games with
+the left space being set to be an actual Space.
+
+Layer 1 (Fn1) contains usual 60% functionalities such as the
+F-row, while Layer 2 (Fn2) contains media controls.
+
+The final layer (Fn4) is a special layer that acts as a lock
+layer, meaning the keyboard is locked while the layer
+is active. This firmware assumes a lock switch (read below).
+
+### Lock switches
+
+1.25u between the split space halves and the 1u key right
+left of LeftArrow are to be operated with a lock switch.
+If you don't have lock switches you should swap the `MO()`
+calls with `TG()` calls to make the layer toggles work
+with regular non/locking switches.
+
+## How to make and flash
+
+(These instructions are for Linux-based operating systems
+with `dfu-programmer` available.)
+
+`cd` into the `bananasplit` keyboard's directory and run
+
+ make rask
+
+which should result in a file called `bananasplit_rask.hex` appearing
+in your QMK root directory.
+
+Now plug in your BananaSplit60 keyboard via USB. Verify
+with `lsusb` that it appears. At least my PCB did not have
+anything preflashed so you should see `atmega32u4` or similar
+in the `lsusb` output.
+
+Now you can flash the firmware by
+
+ $ sudo dfu-programmer atmega32u4 erase
+ $ cd /qmk_firmware/root/directory
+ $ sudo dfu-programmer atmega32u4 flash bananasplit_rask.hex
+
+_If_ you happen to have some other `atmega32u4` based device
+I suggest you plug it out before flashing your BS60 just to
+prevent accidentally flashing your old device.