diff options
| author | coderkun <olli@coderkun.de> | 2017-04-01 10:56:29 +0200 |
|---|---|---|
| committer | coderkun <olli@coderkun.de> | 2017-04-01 10:56:29 +0200 |
| commit | 605c4129cc89e8fe647881108b0c9c79d4da1aea (patch) | |
| tree | 9af55a60d567bd66b5c8572c04ab63b62abb5a02 /keyboards/kinesis/stapelberg/readme.md | |
| parent | b0ade6dc9838d4112cbc3093ac3033aa81ef172d (diff) | |
| parent | 3448d5d4874a2775f85320a2be69edd241575d46 (diff) | |
| download | qmk_firmware-605c4129cc89e8fe647881108b0c9c79d4da1aea.tar.gz qmk_firmware-605c4129cc89e8fe647881108b0c9c79d4da1aea.zip | |
Merge branch 'master' into coderkun_neo2
Diffstat (limited to 'keyboards/kinesis/stapelberg/readme.md')
| -rw-r--r-- | keyboards/kinesis/stapelberg/readme.md | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/keyboards/kinesis/stapelberg/readme.md b/keyboards/kinesis/stapelberg/readme.md new file mode 100644 index 0000000000..b04a0bd49c --- /dev/null +++ b/keyboards/kinesis/stapelberg/readme.md @@ -0,0 +1,55 @@ +# kinesis_stapelberg keyboard firmware + +This folder contains the firmware customization required to run QMK on the custom controller for the Kinesis Advantage created by Michael Stapelberg. +It differs from the `alvicstep keyboard in that the existing QMK Kinesis Advantage project uses the existing controller board provided by Kinesis. + +The controller board hardware is described +[here](http://michael.stapelberg.de/Artikel/kinesis_custom_controller) + +Mapping the pin assignments was done using the corresponding matrix description provided at this +[link](https://github.com/stapelberg/kinesis-firmware/blob/master/kb_kinesis/config.kspec) + +This code makes no attempt to drive the four LEDs provided on the controller board. + + +## Building the Hardware + +If you want to perform this customization, these parts may be helpful. + +| Function | Quantity | Vendor | Part Number | +| ------------------------------------------------------ | -------- | ------- | ------------ | +| 13 pin connector for function keys and finger keywells | 4 | Digi-Key | WM14526-ND | +| 10 pin headers for thumb clusters | 4 | Digi-Key | 609-3250-ND | +| 8 pin cable for thumb clusters | 2 | Digi-Key | SAM8928-ND | +| Teensy++ 2.0 | 1 | Digi-Key | 1528-1056-ND | +| 2 pin right angle header for reset | 1 | Digi-Key | 3M9467-ND | +| Reset cables | 2 | Sparkfun | PRT-09140 | + +The board and connections are shown here + + +The Teensy mounting detail can be seen here. +I used a socket for prototyping. + + + +Since the proper mounting of the Teensy board places the reset button in a tight space, I added a 2-pin header to the reset and ground pins on the edge of the board. +Shorting these two pins together will reset the board. +I also put female to male header jumper cables on these so they could be accessed outside the enclosure. +The exterior cables can be seen here. + + + +## Keymaps + +### Default + +To build with the default keymap, run `make default` while in the +`kinesis_stapelberg` working directory. + +### Dvorak + +This keymap contains a dvorak implementation as well as media and symbol layers. + +Run `make dvorak` while in the `kinesis_stapelberg` working directory. + |