Add Makefiles for TMK converters.
[tmk_keyboard.git] / converter / ps2_usb / README.md
index 8f06fdd00d0c5e5e3adf74509e6e3d8cb5174e61..537e92e64fcc4092d9128ee24a02c0b97194c721 100644 (file)
@@ -1,31 +1,17 @@
 PS/2 to USB keyboard converter
 ==============================
-This firmware converts PS/2 keyboard protocol to USB and supports only Scan Code Set 2.
-
-
-PS/2 signal handling implementations
-------------------------------------
-Following three methods are used to implement PS/2 signal handling.
-
-### Simple and stupid busy-wait(ps2_busywait.c)
-    This is expected to implemented with portable C code for reference.
-### Interrupt driven(ps2_interrupt.c)
-    Uses pin interrupt to detect falling edge of clock line.
-### USART hardware module(ps2_usart.c)
-    Uses AVR USART engine to receive PS/2 signal.
-
-To select method edit Makefile.
+This firmware converts PS/2 keyboard protocol to USB.(It supports Scan Code Set 2.)
 
 
 Connect Wires
 -------------
 In case of Teensy2.0(ATMega32U4):
 
-1. Connect Vcc and GND.
-2. Connect Clock and Data line. 
-    - Busywait:    Clock is on PD5 and Data on PD2.
-    - Interrupt:   Clock is on PD1 and Data on PD2.
-    - USART:       Clock is on PD5 and Data on PD2.
+1. Connect **Vcc** and **GND**.
+2. Connect **Clock** and **Data** line. 
+    - **Interrupt**:   **Clock** is on `PD1` and **Data** on `PD0`.(Recommended. Soarer's converter compatible)
+    - **Busywait**:    **Clock** is on `PD1` and **Data** on `PD0`.
+    - **USART**:       **Clock** is on `PD5` and **Data** on `PD2`.
 3. Optionally you need pull-up register. 1K-10K Ohm is OK.
 
 To change pin configuration edit config.h.
@@ -33,18 +19,41 @@ To change pin configuration edit config.h.
 
 Build Firmware
 --------------
-Just run `make`:
+For **PJRC Teensy** just run `make`:
 
+    $ make clean
     $ make
 
 To select keymap:
 
+    $ make clean
     $ make KEYMAP=[plain|jis|spacefn|...]
 
+After that you will find HEX file `ps2_usb_lufa.hex` in current directory.
+
+
+- For **TMK converter Rev.1** use `make -f Makefile.tmk_rev1` instead of `make` and HEX file is `ps2_usb_tmk_rev1.hex`.
+
+- For **TMK converter Rev.2** use `make -f Makefile.tmk_rev2` instead of `make` and HEX file is `ps2_usb_tmk_rev2.hex`.
+
 
 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.
+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 README.md of top directory) and existent keymap files.
+
+
+PS/2 signal handling implementations
+------------------------------------
+Following three methods can be used to implement PS/2 signal handling.
+
+### Simple and stupid busy-wait(ps2_busywait.c)
+    This is expected to implemented with portable C code for reference.
+### Interrupt driven(ps2_interrupt.c)
+    Uses pin interrupt to detect falling edge of clock line.
+### USART hardware module(ps2_usart.c)
+    Uses AVR USART engine to receive PS/2 signal.
+
+To select method edit Makefile.
 
 
 V-USB Support
Imprint / Impressum