usb_usb: Add debug print for low level

[max/tmk_keyboard.git] / converter / ibm4704_usb / README.md

diff --git a/converter/ibm4704_usb/README.md b/converter/ibm4704_usb/README.md
index a3af4ab31dc7f96f4d3cc1632b4f4dc455b1c4bc..38478455d6dbc500e724167d5a06a8d270a34cc0 100644 (file)
--- a/converter/ibm4704_usb/README.md
+++ b/converter/ibm4704_usb/README.md
@@ -1,17 +1,27 @@
 IBM 4704 to USB keyboard converter
 ==================================
 This firmware converts IBM 4704 keyboard protocol to USB HID.
 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. **You may need to plug USB cable after hooking up your keyboard to the converter.**
+
+TMK Converter for IBM4704 is available here: https://geekhack.org/index.php?topic=72052.0
+
+
+Update
+------
+- 2016/09/30  Unimap editor support
+- 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.

 
 

-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:
 
 
 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
+- 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:
 
 
 ### Alps switch(vintage Green) models:
 


@@ -39,24 +49,39 @@ Keyboard Plug from front:
 
 Connection
 ----------
 
 Connection
 ----------

-In case of using ATMega32U4(Teensy2.0):
+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.
 
 
 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`:
 
 
 Build Firmware
 --------------
 Just run `make`:
 

-    $ make
+    $ make -f <makefile>
+
+For TMK Converter rev.1 use `Makefile.rev1` as makefile:
+
+    $ make -f Makefile.rev1
+
+For TMK Converter rev.2 use `Makefile.rev2` as makefile:
+
+    $ make -f Makefile.rev2

 
 To select keymap:
 
 
 To select keymap:
 

-    $ make KEYMAP=[plain|...]
+    $ make -f <makefile> KEYMAP=[plain|alsp102key|...]
+
+To indentify your TMK Converter revision see [this](https://github.com/tmk/keyboard_converter#pcb-revisions).

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