qmk-dactyl-manuform-a/converter/ibm4704_usb/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.**


Update
------
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:
- 6019273 Model 100 50-key (grid layout)      http://kishy.ca/?p=894
- 6019284 Model 200 62-key Alpha(60% layout)  http://kishy.ca/?p=894
- 6019303 Model 300 77-key Expanded Alpha     http://deskthority.net/photos-f62/ibm-6019303-t8502.html
- 6020218 Model 400 107-key Full key          http://kishy.ca/?p=894

### 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):

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.


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.
Add Initial files of 4704_usb 2014-02-08 18:42:17 +01:00			`IBM 4704 to USB keyboard converter`
Add keymap_hasu.c 2014-02-10 02:01:42 +01:00			`==================================`
Add Initial files of 4704_usb 2014-02-08 18:42:17 +01:00			`This firmware converts IBM 4704 keyboard protocol to USB HID.`

Change pin configuration 2014-02-10 16:37:19 +01:00			`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.`

Add Initial files of 4704_usb 2014-02-08 18:42:17 +01:00
ibm4704_usb: Add keymaps for 107 and 50-key 2015-05-05 05:10:22 +02:00			`Update`
			`------`
			`2015/05/05 Added keymaps for 107-key, 77-key and 50-key. Thanks, orihalcon @ geekhack!`
ibm4704_usb: Fix protocol handling 2015-05-18 17:32:58 +02:00			`2015/05/19 Fixed a protocol handling bug.`
ibm4704_usb: Add keymaps for 107 and 50-key 2015-05-05 05:10:22 +02:00


Fix markdown syntax 2014-02-17 08:57:02 +01:00			`Supported Keyboard`
			`------------------`
			`### IBM capacitive switch models:`
ibm4704_usb: Add keymaps for 107 and 50-key 2015-05-05 05:10:22 +02:00			`- 6019273 Model 100 50-key (grid layout) http://kishy.ca/?p=894`
			`- 6019284 Model 200 62-key Alpha(60% layout) http://kishy.ca/?p=894`
			`- 6019303 Model 300 77-key Expanded Alpha http://deskthority.net/photos-f62/ibm-6019303-t8502.html`
			`- 6020218 Model 400 107-key Full key http://kishy.ca/?p=894`
Fix markdown syntax 2014-02-17 08:57:02 +01:00
			`### 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`
Fix README.md and ibm4704.txt 2014-02-17 08:42:43 +01:00

			`Connector`
			`---------`
Change pin configuration 2014-02-10 16:37:19 +01:00			`Keyboard Plug from front:`
Add README.md 2014-02-09 23:02:48 +01:00
			`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):`

			`1. Supply power with VCC and GND.`
Change pin configuration 2014-02-10 16:37:19 +01:00			`2. Connect CLOCK to PD1 and DATA to PD0. You can change pin with config.h.`
Add README.md 2014-02-09 23:02:48 +01:00			`3. Optionally you may need pull-up register. 1KOhm probably work.`
Add Initial files of 4704_usb 2014-02-08 18:42:17 +01:00

			`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.