Keyboard firmwares for Atmel AVR and Cortex-M
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tmk a88ad58342 core: Swap position of PEQL and PENT in unimap 7 years ago
..
binary ps2_usb: Use standby mode in suspend 7 years ago
Makefile Fix Makefile for NKRO comment 7 years ago
Makefile.mbed Remove keymap read code from project directories 7 years ago
Makefile.rev1 ps2_usb: Change Makefiles 7 years ago
Makefile.rev2 ps2_usb: Change Makefiles 7 years ago
Makefile.unimap.rev1 ps2_usb: Change Makefiles 7 years ago
Makefile.unimap.rev2 ps2_usb: Add setting for suart debug 7 years ago
Makefile.vusb Remove keymap read code from project directories 7 years ago
README.md ps2_usb: Change Makefiles 7 years ago
config.h ps2_usb: Support for hidden switch in model M 7 years ago
config_mbed.h Port ps2_usb to mbed 9 years ago
config_rev1.h ps2_usb: Support for hidden switch in model M 7 years ago
config_rev2.h ps2_usb: Support for hidden switch in model M 7 years ago
keymap_common.h ps2_usb: Support for hidden switch in model M 7 years ago
keymap_jis.c Fix: Use action_t in keymap files 7 years ago
keymap_plain.c Fix: Use action_t in keymap files 7 years ago
keymap_spacefn.c Fix: Use action_t in keymap files 7 years ago
led.c Made directories for keyboard and converter projects. 11 years ago
main.cpp Port ps2_usb to mbed 9 years ago
matrix.c Fix matrix_clear() for new matrix API 7 years ago
unimap_plain.c core: Swap position of PEQL and PENT in unimap 7 years ago
unimap_trans.h core: Swap position of PEQL and PENT in unimap 7 years ago
usbconfig.h Fix PS/2 protocol build options 11 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

  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. You need pull-up resistors. 1K-10K Ohm would be fine.

To change pin configuration edit config.h and Makefile.

Build Firmware

For TMK converter Rev.2:

$ make -f Makefile.rev2 clean
$ make -f Makefile.rev2 KEYMAP=plain

To program firmware push the button on converter and run:

$ make -f Makefile.rev2 KEYMAP=plain dfu
  • For TMK converter Rev.1 use make -f Makefile.rev1 instead.
  • To select keymap use jis, spacefn or your own in place of 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 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

With V-USB you can use this converter on ATmega(168/328) but it doesn’t support NKRO at this time.

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)