You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
qmk_firmware/converter/ps2_usb
Robin Haberkorn 388fe60c67 fixed PS/2 keyboard converter config
When using the PS/2 interrupt implementation, the DATA pin should be
PD0 as the documentation (README.md) states.
10 years ago
..
Makefile Add Makefiles for TMK converters. 11 years ago
Makefile.pjrc Add new keymap file 11 years ago
Makefile.tmk_rev1 Add Makefiles for TMK converters. 11 years ago
Makefile.tmk_rev2 Add Makefiles for TMK converters. 11 years ago
Makefile.vusb Fix BOOTLOADER_SIZE setting 12 years ago
README.md Fixing typo 11 years ago
config.h fixed PS/2 keyboard converter config 10 years ago
config_tmk_rev1.h Add Makefiles for TMK converters. 11 years ago
config_tmk_rev2.h Fix keymap of ps2_usb 11 years ago
keymap_common.c Add new keymap file 11 years ago
keymap_common.h Add new keymap file 11 years ago
keymap_jis.c Add SpaceFN keymap and JIS keymap 11 years ago
keymap_plain.c Add SpaceFN keymap and JIS keymap 11 years ago
keymap_spacefn.c Fix keymap of ps2_usb 11 years ago
led.c Made directories for keyboard and converter projects. 13 years ago
matrix.c Fix key stack and PS/2 Overrun 11 years ago
usbconfig.h Fix PS/2 protocol build options 12 years ago

README.md

PS/2 to USB keyboard converter

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.
    • 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 resistor. 1K-10K Ohm is OK.

To change pin configuration edit config.h.

Build Firmware

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

You can also use this converter on ATmega(168/328) with V-USB instead of Teensy. The converter on V-USB lacks some features for now: USB NKRO and System/Media control.

Circuit:

                +---+   +---------------+
USB            GND  |   |   ATmega168   |
===                 C3  |               |
5V <-------+--------+---|Vcc,AVCC       |        PS/2
           R1           |               |        ====
D- <----+--+-----R2-----|INT1        RXD|------->DATA
D+ <----|---+----R3-----|INT0        XCK|------->CLOCK
        Z1  Z2          |               |      ->5V
GND<----+---+--+--+-----|GND            |      ->GND
               |  |     |               |
               |  C2-+--|XTAL1          |
               |     X1 |               |
               +--C3-+--|XTAL2          |
                        +---------------+
R1:     1.5K Ohm
R2,R3:  68 Ohm
Z1,Z2:  Zenner 3.6V
C1,C2:  22pF
C3:     0.1uF
X1:     Crystal 20MHz(16MHz/12MHz)