mirror of https://github.com/openstenoproject/qmk synced 2024-11-13 20:14:40 +00:00

History

tmk e2077cad45 Change key_t to keypos_t		2014-11-24 15:14:52 +09:00
..
config.h	Change IS_COMMAND macro	2014-02-17 16:41:40 +09:00
ibm4704.txt	Fix README.md and ibm4704.txt	2014-02-17 16:42:43 +09:00
keymap_common.c	Change key_t to keypos_t	2014-11-24 15:14:52 +09:00
keymap_common.h	Add keymap_hasu.c	2014-02-10 10:01:42 +09:00
keymap_hasu.c	Add keymap_hasu.c	2014-02-10 10:01:42 +09:00
keymap_plain.c	Change keymap_plain.c	2014-02-11 01:55:49 +09:00
led.c
Makefile	Add keymap_hasu.c	2014-02-10 10:01:42 +09:00
matrix.c
README.md	Fix markdown syntax	2014-02-17 16:57:02 +09:00

README.md

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.

Supported Keyboard

IBM capacitive switch models:

6019273 Model 100 50-key (grid layout) http://kishy.dyndns.org/?p=977
6019284 Model 200 62-key Alpha(60% layout) http://kishy.dyndns.org/?p=894
6019303 Model 300 77-key Expanded Alpha http://kbtalking.cool3c.com/article/23272
6020218 Model 400 107-key Full key http://kishy.dyndns.org/?p=980

Alps switch(vintage Green) models:

5954339 Japanese 102-key http://deskthority.net/post87127.html#p87127
6112883 Japanese 102-key http://geekhack.org/index.php?topic=52888.msg1194489#msg1194489
6112884 Japanese 102-key http://geekhack.org/index.php?topic=50437.msg1193047#msg1193047
6341739 Chinese 102-key http://geekhack.org/index.php?topic=52888.msg1176566#msg1176566

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(Teensy2.0):

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

Build Firmware

Just run make:

$ make

To select keymap:

$ make KEYMAP=[plain|...]

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.