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

86 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

2014-02-08 17:42:17 +00:00
IBM 4704 to USB keyboard converter
2014-02-10 01:01:42 +00:00
==================================
2014-02-08 17:42:17 +00:00
This firmware converts IBM 4704 keyboard protocol to USB HID.
2014-02-10 15:37:19 +00: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.**
2014-02-08 17:42:17 +00:00
Update
------
2016-02-02 05:27:19 +00:00
- 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.
2014-02-17 07:57:02 +00:00
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
2014-02-17 07:57:02 +00: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
2014-02-17 07:42:43 +00:00
Connector
---------
2014-02-10 15:37:19 +00:00
Keyboard Plug from front:
2014-02-09 22:02:48 +00: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/U2
2014-02-09 22:02:48 +00:00
1. Supply power with VCC and GND.
2014-02-10 15:37:19 +00:00
2. Connect CLOCK to PD1 and DATA to PD0. You can change pin with config.h.
2014-02-09 22:02:48 +00:00
3. Optionally you may need pull-up register. 1KOhm probably work.
2014-02-08 17:42:17 +00:00
TMK Converter can supports IBM 4704.
https://github.com/tmk/keyboard_converter
2014-02-08 17:42:17 +00:00
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
2014-02-08 17:42:17 +00:00
To select keymap:
$ make -f <makefile> KEYMAP=[plain|...]
To indentify your TMK Converter revision see [this](https://github.com/tmk/keyboard_converter#pcb-revisions).
2014-02-08 17:42:17 +00:00
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.