qmk_firmware/keyboards/handwired/space_oddity/readme.md

Space Oddity Keyboard
=====================

This firmware is for an Emacs-focused handwired custom keyboard using an Arduino Pro Micro.

As originally designed, the top row consists of 2u keys which are used for user-defined macros. The keys for Shift and Enter are 1.75u.

Some simple example macros are included. To add your own, just add the number of the macro you want in the appropriate section.

A picture of the finished product can be found here: https://imgur.com/dE9Y4XK

## Pinout

The following pins are used:
- Columns 1-12: B2, B6, B5, B4, E6, D7, C6, D4, D0, D1, D2, D3
- Rows 1-6: F4, F5, F6, F7, B1, B3

## Compiling and loading the firmware

To build the firmware, run `make handwired/space_oddity` from the toplevel directory.

On GNU/Linux, you can flash the default layout onto the microcontroller by using `avrdude -p atmega32u4 -P /dev/ttyACM0 -c avr109 -U flash:w:handwired_space_oddity_default.hex`. Note that the device name under `/dev` may be different. 


This design was conceived by James Taylor. Any requests for further information, suggestions, and/or tips for building your own are welcome!
Additional custom handwired layout - Space Oddity (#1868) * Add existing file * Add new keyboard layout - initial commit * Revised readme.md * Clarified readme.md, reorganized keymap.c, and added license text. * Fixing last incomplete commit * Just a little code cleanup to make things more readable. 2017-10-21 13:04:35 -07:00			`Space Oddity Keyboard`
			`=====================`

			`This firmware is for an Emacs-focused handwired custom keyboard using an Arduino Pro Micro.`

			`As originally designed, the top row consists of 2u keys which are used for user-defined macros. The keys for Shift and Enter are 1.75u.`

Some finishing touches on space_oddity (#1892) * Add verbose comments, ASCII layout pictures, and re-word readme.md * Fix omission of F(2) on the third layer. 2017-10-23 11:26:52 -07:00			`Some simple example macros are included. To add your own, just add the number of the macro you want in the appropriate section.`
Additional custom handwired layout - Space Oddity (#1868) * Add existing file * Add new keyboard layout - initial commit * Revised readme.md * Clarified readme.md, reorganized keymap.c, and added license text. * Fixing last incomplete commit * Just a little code cleanup to make things more readable. 2017-10-21 13:04:35 -07:00
			`A picture of the finished product can be found here: https://imgur.com/dE9Y4XK`

			`## Pinout`

			`The following pins are used:`
			`- Columns 1-12: B2, B6, B5, B4, E6, D7, C6, D4, D0, D1, D2, D3`
			`- Rows 1-6: F4, F5, F6, F7, B1, B3`

			`## Compiling and loading the firmware`

Some finishing touches on space_oddity (#1892) * Add verbose comments, ASCII layout pictures, and re-word readme.md * Fix omission of F(2) on the third layer. 2017-10-23 11:26:52 -07:00			To build the firmware, run `make handwired/space_oddity` from the toplevel directory.
Additional custom handwired layout - Space Oddity (#1868) * Add existing file * Add new keyboard layout - initial commit * Revised readme.md * Clarified readme.md, reorganized keymap.c, and added license text. * Fixing last incomplete commit * Just a little code cleanup to make things more readable. 2017-10-21 13:04:35 -07:00
			On GNU/Linux, you can flash the default layout onto the microcontroller by using `avrdude -p atmega32u4 -P /dev/ttyACM0 -c avr109 -U flash:w:handwired_space_oddity_default.hex`. Note that the device name under `/dev` may be different.


Some finishing touches on space_oddity (#1892) * Add verbose comments, ASCII layout pictures, and re-word readme.md * Fix omission of F(2) on the third layer. 2017-10-23 11:26:52 -07:00			`This design was conceived by James Taylor. Any requests for further information, suggestions, and/or tips for building your own are welcome!`