summaryrefslogtreecommitdiffstats
path: root/keyboards/bananasplit/keymaps/rask/README.md
diff options
context:
space:
mode:
authorOtto Rask <ojrask@gmail.com>2017-08-30 17:51:18 +0200
committerJack Humbert <jack.humb@gmail.com>2017-08-30 17:51:18 +0200
commitda33dfec558cba45431b426b8ebe5fba77f6f572 (patch)
treefbad768ae136f86a13cb762443e679f9b92f94d0 /keyboards/bananasplit/keymaps/rask/README.md
parenta4316ba486ae25eae93174f5d7e4952811680601 (diff)
downloadqmk_firmware-da33dfec558cba45431b426b8ebe5fba77f6f572.tar.gz
qmk_firmware-da33dfec558cba45431b426b8ebe5fba77f6f572.tar.xz
rask's Satan and BananaSplit60 (#1654)
* Add rask's Satan layout * Add rask's Satan layout * Add rask's BananaSplit60 layout * Add rask's BS60 readme * Fix rask's BS60 readme image * Fix rask's BS60 readme image again
Diffstat (limited to 'keyboards/bananasplit/keymaps/rask/README.md')
-rw-r--r--keyboards/bananasplit/keymaps/rask/README.md53
1 files changed, 53 insertions, 0 deletions
diff --git a/keyboards/bananasplit/keymaps/rask/README.md b/keyboards/bananasplit/keymaps/rask/README.md
new file mode 100644
index 000000000..ec19d3935
--- /dev/null
+++ b/keyboards/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.