mirror of
https://github.com/mcgurk/Arduino-USB-HID-RetroJoystickAdapter
synced 2024-11-11 03:35:11 -05:00
147 lines
3.3 KiB
Markdown
147 lines
3.3 KiB
Markdown
# Soarer PS/2 to USB keyboard converter
|
|
https://deskthority.net/workshop-f7/xt-at-ps2-terminal-to-usb-converter-with-nkro-t2510.html
|
|
|
|
#### Keyboard protocols supported:
|
|
- XT (scan code set 1)
|
|
- AT (scan code set 2)
|
|
- PS/2 (MF2) (extended scan code set 2)
|
|
- Terminal e.g. 3179/318x/319x (scan code set 3)
|
|
#### Configurable Features: (v0.997+)
|
|
- Remapping
|
|
- Layers
|
|
- Macros
|
|
- On-the-fly Config Selection
|
|
#### Other Features:
|
|
- Full NKRO, if the keyboard supports it (even on Macs!)
|
|
- Boot mode support (even with faulty BIOS!)
|
|
- Auto-detection of the keyboard type
|
|
- XT and AT boards are remapped correctly for PrtSc etc.
|
|
- 1000Hz polling using Full Speed USB
|
|
- Suspend and resume support
|
|
- Media and Power key support
|
|
- Jump to bootloader function (update firmware without pressing the reset button) (v1.0+)
|
|
|
|
|
|
|
|
## Hardware
|
|
You need
|
|
- ATMega32U4 Microcontroller/Arduino. E.g. Arduino Pro Micro
|
|
- PS/2 female connector
|
|
|
|
PS/2 -> Arduino
|
|
- Data (green) -> PD0 (Pro Micro: 3)
|
|
- CLK (white) -> PD1 (Pro Micro: 2)
|
|
- 5V (red) -> 5V
|
|
- GND (black) -> GND
|
|
|
|
##### Arduino Pro Micro pinout
|
|
http://www.pighixxx.com/test/wp-content/uploads/2016/07/pro_micro_pinout_v1_0_red.png
|
|
|
|
##### PS/2 pinout
|
|
http://ezcontents.org/sites/default/files/ps2_pinout.png
|
|
|
|
## Firmware
|
|
https://deskthority.net/workshop-f7/xt-at-ps2-terminal-to-usb-converter-with-nkro-t2510.html
|
|
|
|
Soarer_Converter_v1.12_update.zip: https://deskthority.net/resources/file/8295
|
|
|
|
#### Flasher
|
|
https://sourceforge.net/projects/winavr/
|
|
#### Flashing
|
|
```
|
|
avrdude -p m32u4 -b 57600 -P com5 -c avr109 -U flash:w:Soarer_at2usb_v1.12_atmega32u4.hex
|
|
```
|
|
Bootloader mode: RST to GND two times. You have couple of seconds to start flashing. Serial port can be different than in normal mode.
|
|
|
|
|
|
## Testing/Debugging
|
|
hid_listen.exe: https://www.pjrc.com/teensy/hid_listen.html
|
|
|
|
## Settings/Tools/Docs
|
|
https://deskthority.net/workshop-f7/xt-at-ps2-terminal-to-usb-converter-with-nkro-t2510.html
|
|
|
|
Tools and docs (Soarer_Converter_v1.10.zip): https://deskthority.net/resources/file/6142
|
|
|
|
Key names/codes: docs/codes.html
|
|
|
|
Compile text file to binary
|
|
```
|
|
scas xarcade.txt xarcade.bin
|
|
```
|
|
Upload config (effective immediately)
|
|
```
|
|
scwr xarcade.bin
|
|
```
|
|
|
|
## Links
|
|
- https://geekhack.org/index.php?topic=17458.0
|
|
- http://www.computer-engineering.org/ps2protocol/
|
|
- http://www.computer-engineering.org/ps2keyboard/
|
|
- http://www.computer-engineering.org/ps2keyboard/scancodes2.html
|
|
- test: https://www.microsoft.com/appliedsciences/KeyboardGhostingDemo.mspx
|
|
|
|
## Keyboard controller
|
|
- https://geekhack.org/index.php?topic=50437.0
|
|
- https://deskthority.net/workshop-f7/soarer-s-keyboard-controller-firmware-t6767.html
|
|
Soarer_Controller_v1.20_beta4.zip
|
|
|
|
|
|
## X-Arcade (xarcade.txt)
|
|
```
|
|
# scas xarcade.txt xarcade.bin
|
|
# scwr xarcade.bin
|
|
force set2ext
|
|
|
|
# dir1 keypad 8 (75),2 (72),4 (6B),6 (74)
|
|
# sel1 3
|
|
# start1 1
|
|
# A,B,C: vas shift (12),Z,X
|
|
# X,Y,Z: vas ctrl (14),vas alt (11),space (29)
|
|
# alanapit: c,5
|
|
|
|
remapblock
|
|
# left controller
|
|
PAD_8 W
|
|
PAD_2 S
|
|
PAD_4 A
|
|
PAD_6 D
|
|
LSHIFT SPACE
|
|
|
|
Z F
|
|
X G
|
|
LCTRL R
|
|
LALT T
|
|
SPACE Y
|
|
C V # "normal"
|
|
# C RCTRL # "commando"
|
|
5 B
|
|
3 Q
|
|
1 E
|
|
|
|
# right controller
|
|
R PAD_8
|
|
F PAD_2
|
|
D PAD_4
|
|
G PAD_6
|
|
W RCTRL
|
|
|
|
E K
|
|
LEFT_BRACE L
|
|
A I
|
|
S O
|
|
Q P
|
|
RIGHT_BRACE N # "normal"
|
|
# RIGHT_BRACE SPACE # "commando"
|
|
6 M
|
|
2 U
|
|
4 J
|
|
endblock
|
|
|
|
# dir2 r,f,d,g
|
|
# sel2 4
|
|
# start2 2
|
|
# A,B,C: w,e,}(å)(54="[")
|
|
# X,Y,Z: a,s,q
|
|
# alanapit: ;(¨)(5B="]"),6
|
|
```
|