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.
		
		
		
		
		
			
		
			
				
					56 lines
				
				2.4 KiB
			
		
		
			
		
	
	
					56 lines
				
				2.4 KiB
			| 
								 
											9 years ago
										 
									 | 
							
								# 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.
							 | 
						||
| 
								 | 
							
								
							 |