converter/adb_usb/README

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