1
0
mirror of https://github.com/mcgurk/Arduino-USB-HID-RetroJoystickAdapter synced 2024-12-22 07:28:53 -05:00
Arduino-USB-HID-RetroJoysti.../PS2_Soarer_Converter
2017-08-14 11:23:28 +03:00
..
README.md Update README.md 2017-08-14 11:23:28 +03:00

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

Keyboard controller

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