converter/adb_usb/README.md

   1 ADB to USB keyboard converter
   2 =============================
   3 This firmware converts ADB keyboard protocol to USB.
   4 You can use PJRC Teensy for this converter, though, other USB AVR(ATMega32U4, AT90USB64/128 or etc) should work.
   5 But binary size is about 10KB or more it doesn't fit into 8K flash like ATMega8U2.
   6
   7 Discuss: http://geekhack.org/showwiki.php?title=Island:14290
   8
   9
  10 Build
  11 -----
  12 0. Connect ADB keyboard to Teensy by 3 lines(Vcc, GND, Data). By default Data line uses port F0.
  13    This converter uses AVR's internal pull-up, but it seems to be too weak, in particular when you want to use a long or coiled cable.
  14    The external pull-up resistor(1K-10K Ohm) on Data is strongly recommended.
  15 1. Define following macros for ADB connection in config.h if you use other than port F0.
  16    ADB_PORT, ADB_PIN, ADB_DDR, ADB_DATA_BIT
  17 2. make
  18 3. program Teensy
  19
  20
  21 LOCKING CAPSLOCK
  22 ----------------
  23 Many old ADB keyboards have mechanical push-lock switch for Capslock key. This converter support the locking Capslock key by default.
  24 This feature will prevent you from remaping as normal key. You can disable the feature by *commenting out* a macro in config.h like this:
  25
  26     //#define MATRIX_HAS_LOCKING_CAPS
  27
  28 Also you may want to remove locking pin from the push-lock switch to use capslock as a normal momentary switch.
  29 http://www.youtube.com/watch?v=9wqnt2mGJ2Y
  30
  31
  32 Keymap
  33 ------
  34 You can change a keymap by editing code of keymap.c like following.
  35 This is a keymap for AEK, however, also used for other keyboards.
  36 How to define the keymap is probably obvious. You can find key symbols in keycode.h.
  37 If you want to define some keymaps than just one, see hhkb/keymap.c and
  38 macway/keymap.c as examples. Keymap(layer) switching may needs a bit of
  39 effort at this time.
  40
  41     /* Default Layer: plain keymap
  42      * ,---.   ,---------------. ,---------------. ,---------------. ,-----------.             ,---.
  43      * |Esc|   |F1 |F2 |F3 |F4 | |F5 |F6 |F7 |F8 | |F9 |F10|F11|F12| |PrS|ScL|Pau|             |Pwr|
  44      * `---'   `---------------' `---------------' `---------------' `-----------'             `---'
  45      * ,-----------------------------------------------------------. ,-----------. ,---------------.
  46      * |  `|  1|  2|  3|  4|  5|  6|  7|  8|  9|  0|  -|  =|Backspa| |Ins|Hom|PgU| |NmL|  =|  /|  *|
  47      * |-----------------------------------------------------------| |-----------| |---------------|
  48      * |Tab  |  Q|  W|  E|  R|  T|  Y|  U|  I|  O|  P|  [|  ]|    \| |Del|End|PgD| |  7|  8|  9|  -|
  49      * |-----------------------------------------------------------| `-----------' |---------------|
  50      * |CapsLo|  A|  S|  D|  F|  G|  H|  J|  K|  L|  ;|  '|Return  |               |  4|  5|  6|  +|
  51      * |-----------------------------------------------------------|     ,---.     |---------------|
  52      * |Shift   |  Z|  X|  C|  V|  B|  N|  M|  ,|  ,|  /|Shift     |     |Up |     |  1|  2|  3|   |
  53      * |-----------------------------------------------------------| ,-----------. |-----------|Ent|
  54      * |Ctrl |Gui |Alt |         Space           |     |    |      | |Lef|Dow|Rig| |      0|  .|   |
  55      * `-----------------------------------------------------------' `-----------' `---------------'
  56      */
  57     KEYMAP(
  58     ESC, F1,  F2,  F3,  F4,  F5,  F6,  F7,  F8,  F9,  F10, F11, F12,           PSCR,SLCK,BRK,                    PWR,
  59     GRV, 1,   2,   3,   4,   5,   6,   7,   8,   9,   0,   MINS,EQL, BSPC,     INS, HOME,PGUP,    NLCK,EQL, PSLS,PAST,
  60     TAB, Q,   W,   E,   R,   T,   Y,   U,   I,   O,   P,   LBRC,RBRC,BSLS,     DEL, END, PGDN,    P7,  P8,  P9,  PMNS,
  61     CAPS,A,   S,   D,   F,   G,   H,   J,   K,   L,   SCLN,QUOT,     ENT,                         P4,  P5,  P6,  PPLS,
  62     LSFT,Z,   X,   C,   V,   B,   N,   M,   COMM,DOT, SLSH,          RSFT,          UP,           P1,  P2,  P3,
  63     LCTL,LGUI,LALT,          SPC,                                              LEFT,DOWN,RGHT,    P0,       PDOT,PENT
  64     ),
  65
  66
  67 Magic command
  68 -------------
  69 To get help press `h` holding Magic key. Magic key is `Power key`.
  70
  71
  72 Notes
  73 -----
  74 Many ADB keyboards has no discrimination between right modifier and left one,
  75 you will always see left control even if you press right control key.
  76 Apple Extended Keyboard and Apple Extended Keyboard II are the examples.
  77 Though ADB protocol itsef has the ability of distinction between right and left.
  78 And most ADB keyboard has no NKRO functionality, though ADB protocol itsef has that.
  79 See protocol/adb.c for more info.
  80
  81 EOF