1
0
This repo is archived. You can view files and clone it, but cannot push or open issues or pull requests.
tmk_keyboard_custom/converter/ibm4704_usb/README.md
2016-02-02 14:27:19 +09:00

2.6 KiB

IBM 4704 to USB keyboard converter

This firmware converts IBM 4704 keyboard protocol to USB HID.

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.

Update

  • 2015/09/07 Added keymap for Alps 102-key. Thanks, tai @ geekhack!
  • 2015/05/05 Added keymaps for 107-key, 77-key and 50-key. Thanks, orihalcon @ geekhack!
  • 2015/05/19 Fixed a protocol handling bug.

Supported Keyboard

IBM capacitive switch models:

Alps switch(vintage Green) models:

Connector

Keyboard Plug from front:

DSUB-9
-------------
\ N 2 3 4 5 /
 \ N N N N /
  ---------
2   GND
3   VCC 5V
4   DATA
5   CLOCK
N   No connection/No pin.

Connection

In case of using ATMega32U4/U2

  1. Supply power with VCC and GND.
  2. Connect CLOCK to PD1 and DATA to PD0. You can change pin with config.h.
  3. Optionally you may need pull-up register. 1KOhm probably work.

TMK Converter can supports IBM 4704. https://github.com/tmk/keyboard_converter

Build Firmware

Just run make:

$ make -f <makefile>

For TMK Converter rev.1 use Makefile.tmk_rev1 as makefile:

$ make -f Makefile.tmk_rev1

For TMK Converter rev.2 use Makefile.tmk_rev2 as makefile:

$ make -f Makefile.tmk_rev2

To select keymap:

$ make -f <makefile> KEYMAP=[plain|...]

To indentify your TMK Converter revision see this.

Keymap

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.

Use KEYMAP_ALPS102() to define your keymap for Alps models.