1
0
tmk_keyboard/converter/ps2_usb/README.md

79 rivejä
2.7 KiB
Markdown
Raaka Normaali näkymä Historia

2013-11-29 14:52:29 +00:00
PS/2 to USB keyboard converter
==============================
2014-04-29 10:42:24 +00:00
This firmware converts PS/2 keyboard protocol to USB.(It supports Scan Code Set 2.)
2013-11-29 14:52:29 +00:00
Connect Wires
-------------
2014-04-29 10:42:24 +00:00
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`.
2016-09-17 01:20:52 +00:00
3. You need pull-up resistors. 1K-10K Ohm would be fine.
2013-11-29 14:52:29 +00:00
2015-05-18 04:58:56 +00:00
To change pin configuration edit **config.h** and **Makefile**.
2013-11-29 14:52:29 +00:00
2014-01-05 03:45:52 +00:00
Build Firmware
2013-11-29 14:52:29 +00:00
--------------
2016-09-17 01:20:52 +00:00
For **TMK converter Rev.2**:
2013-11-29 14:52:29 +00:00
2016-09-17 01:20:52 +00:00
$ make -f Makefile.rev2 clean
$ make -f Makefile.rev2 KEYMAP=plain
2013-11-29 14:52:29 +00:00
2016-09-17 01:20:52 +00:00
To program firmware push the button on converter and run:
2014-04-29 10:42:24 +00:00
2016-09-17 01:20:52 +00:00
$ make -f Makefile.rev2 KEYMAP=plain dfu
2014-04-29 10:42:24 +00:00
2016-09-17 01:20:52 +00:00
- For **TMK converter Rev.1** use `make -f Makefile.rev1` instead.
- To select keymap use `jis`, `spacefn` or your own in place of `plain`.
2014-04-29 10:42:24 +00:00
2013-11-29 14:52:29 +00:00
Keymap
------
2014-04-29 10:42:24 +00:00
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.
2013-11-29 14:52:29 +00:00
V-USB Support
-------------
2014-11-20 07:47:40 +00:00
With V-USB you can use this converter on ATmega(168/328) but it doesn't support NKRO at this time.
2013-11-29 14:52:29 +00:00
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)