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 4704 Connector
   9 --------------
  10 Keyboard Plug from front:
  11
  12     DSUB-9
  13     -------------
  14     \ N 2 3 4 5 /
  15      \ N N N N /
  16       ---------
  17     2   GND
  18     3   VCC 5V
  19     4   DATA
  20     5   CLOCK
  21     N   No connection/No pin.
  22
  23
  24 Connection
  25 ----------
  26 In case of using ATMega32U4(Teensy2.0):
  27
  28 1. Supply power with VCC and GND.
  29 2. Connect CLOCK to PD1 and DATA to PD0. You can change pin with config.h.
  30 3. Optionally you may need pull-up register. 1KOhm probably work.
  31
  32
  33 Build Firmware
  34 --------------
  35 Just run `make`:
  36
  37     $ make
  38
  39 To select keymap:
  40
  41     $ make KEYMAP=[plain|...]
  42
  43
  44 Keymap
  45 ------
  46 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.