]> git.donarmstrong.com Git - qmk_firmware.git/blob - keyboards/handwired/space_oddity/readme.md
Merge branch 'master' of https://github.com/qmk/qmk_firmware
[qmk_firmware.git] / keyboards / handwired / space_oddity / readme.md
1 Space Oddity Keyboard
2 =====================
3
4 This firmware is for an Emacs-focused handwired custom keyboard using an Arduino Pro Micro.
5
6 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.
7
8 Some simple example macros are included. To add your own, just add the number of the macro you want in the appropriate section.
9
10 A picture of the finished product can be found here: https://imgur.com/dE9Y4XK
11
12 ## Pinout
13
14 The following pins are used:
15 - Columns 1-12: B2, B6, B5, B4, E6, D7, C6, D4, D0, D1, D2, D3
16 - Rows 1-6: F4, F5, F6, F7, B1, B3
17
18 ## Compiling and loading the firmware
19
20 To build the firmware, run `make handwired/space_oddity` from the toplevel directory.
21
22 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. 
23
24
25 This design was conceived by James Taylor. Any requests for further information, suggestions, and/or tips for building your own are welcome!