keyboards/handwired/space_oddity/readme.md

   1 # Space Oddity Keyboard
   2
   3 ![Space Oddity](https://i.imgur.com/dE9Y4XK.jpg)
   4
   5 This firmware is for an Emacs-focused handwired custom keyboard using an Arduino Pro Micro.
   6
   7 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.
   8
   9 Some simple example macros are included. To add your own, just add the number of the macro you want in the appropriate section.
  10
  11 This design was conceived by James Taylor. Any requests for further information, suggestions, and/or tips for building your own are welcome!
  12
  13 Keyboard Maintainer: [James Taylor](https://github.com/broken-username)
  14 Hardware Supported: Arduino Pro Micro
  15
  16 ## Pinout
  17
  18 The following pins are used:
  19 - Columns 1-12: B2, B6, B5, B4, E6, D7, C6, D4, D0, D1, D2, D3
  20 - Rows 1-6: F4, F5, F6, F7, B1, B3
  21
  22 ## Flashing
  23
  24 Make example for this keyboard (after setting up your build environment):
  25
  26     make handwired/space_oddity:default
  27
  28 On GNU/Linux, you can flash the default layout onto the microcontroller by using
  29
  30     avrdude -p atmega32u4 -P /dev/ttyACM0 -c avr109 -U flash:w:handwired_space_oddity_default.hex
  31
  32 Note that the device name under `/dev` may be different.
  33
  34 See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).