You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

53 lines
1.6 KiB

  1. # rask's BananaSplit60
  2. ![BS60 layout](http://i.imgur.com/Q7so1py.png)
  3. ## Notes
  4. ### Layers
  5. Base layer is a regular HHKBish ANSI layer. Toggling the
  6. alternate base layer (Fn3) makes it simpler to play games with
  7. the left space being set to be an actual Space.
  8. Layer 1 (Fn1) contains usual 60% functionalities such as the
  9. F-row, while Layer 2 (Fn2) contains media controls.
  10. The final layer (Fn4) is a special layer that acts as a lock
  11. layer, meaning the keyboard is locked while the layer
  12. is active. This firmware assumes a lock switch (read below).
  13. ### Lock switches
  14. 1.25u between the split space halves and the 1u key right
  15. left of LeftArrow are to be operated with a lock switch.
  16. If you don't have lock switches you should swap the `MO()`
  17. calls with `TG()` calls to make the layer toggles work
  18. with regular non/locking switches.
  19. ## How to make and flash
  20. (These instructions are for Linux-based operating systems
  21. with `dfu-programmer` available.)
  22. `cd` into the `bananasplit` keyboard's directory and run
  23. make rask
  24. which should result in a file called `bananasplit_rask.hex` appearing
  25. in your QMK root directory.
  26. Now plug in your BananaSplit60 keyboard via USB. Verify
  27. with `lsusb` that it appears. At least my PCB did not have
  28. anything preflashed so you should see `atmega32u4` or similar
  29. in the `lsusb` output.
  30. Now you can flash the firmware by
  31. $ sudo dfu-programmer atmega32u4 erase
  32. $ cd /qmk_firmware/root/directory
  33. $ sudo dfu-programmer atmega32u4 flash bananasplit_rask.hex
  34. _If_ you happen to have some other `atmega32u4` based device
  35. I suggest you plug it out before flashing your BS60 just to
  36. prevent accidentally flashing your old device.