converter/ibm4704_usb/README.md

   1 IBM 4704 to USB keyboard converter
   2 ==================================
   3 This firmware converts IBM 4704 keyboard protocol to USB HID.
   4
   5 Keyboard initialization process takes a few seconds at start up. During that you will hear buzzer from the keyboard. **You need to plug USB cable after hooking up your keyboard to the converter.**
   6
   7
   8 Update
   9 ------
  10 2015/05/05  Added keymaps for 107-key, 77-key and 50-key. Thanks, orihalcon @ geekhack!
  11 2015/05/19  Fixed a protocol handling bug.
  12
  13
  14
  15 Supported Keyboard
  16 ------------------
  17 ### IBM capacitive switch models:
  18 - 6019273 Model 100 50-key (grid layout)      http://kishy.ca/?p=894
  19 - 6019284 Model 200 62-key Alpha(60% layout)  http://kishy.ca/?p=894
  20 - 6019303 Model 300 77-key Expanded Alpha     http://deskthority.net/photos-f62/ibm-6019303-t8502.html
  21 - 6020218 Model 400 107-key Full key          http://kishy.ca/?p=894
  22
  23 ### Alps switch(vintage Green) models:
  24
  25 - 5954339 Japanese 102-key    http://deskthority.net/post87127.html#p87127
  26 - 6112883 Japanese 102-key    http://geekhack.org/index.php?topic=52888.msg1194489#msg1194489
  27 - 6112884 Japanese 102-key    http://geekhack.org/index.php?topic=50437.msg1193047#msg1193047
  28 - 6341739 Chinese 102-key     http://geekhack.org/index.php?topic=52888.msg1176566#msg1176566
  29
  30
  31 Connector
  32 ---------
  33 Keyboard Plug from front:
  34
  35     DSUB-9
  36     -------------
  37     \ N 2 3 4 5 /
  38      \ N N N N /
  39       ---------
  40     2   GND
  41     3   VCC 5V
  42     4   DATA
  43     5   CLOCK
  44     N   No connection/No pin.
  45
  46
  47 Connection
  48 ----------
  49 In case of using ATMega32U4(Teensy2.0):
  50
  51 1. Supply power with VCC and GND.
  52 2. Connect CLOCK to PD1 and DATA to PD0. You can change pin with config.h.
  53 3. Optionally you may need pull-up register. 1KOhm probably work.
  54
  55
  56 Build Firmware
  57 --------------
  58 Just run `make`:
  59
  60     $ make
  61
  62 To select keymap:
  63
  64     $ make KEYMAP=[plain|...]
  65
  66
  67 Keymap
  68 ------
  69 Several version of keymap are available in advance but you are recommended to define your favorite layout yourself. To define your own keymap create file named `keymap_<name>.c` and see keymap document(you can find in top README.md) and existent keymap files.