sonik-br / RetroZordAdapter

Arduino multiple controller adapter
GNU General Public License v3.0
23 stars 2 forks source link
arduino controller guncon input jogcon megadrive misterfpga multitap negcon playstation sega-saturn snes

RetroZordAdapter

Arduino multiple controller adapter

This is a collection of my various arduino based adapters.

The output can be configured to:

There's adapters for:

And also a more complex adapter including the 3 adapters on a single arduino

Each adapter have at least a unique USB Serial ID.
This is usefull on MiSTer as it can distinguish each Arduino based adapter by it's ID and each adapter will have it's own input mapping.
The PlayStation adapter have multiple IDs as it implements various output modes.

Arduino's LED_BUILTIN will blink when no controller is connected. It's cool to have the LED visible if building the adapter inside a case.

Output modes and features

Dinput Xinput Switch PS3
Output devices 5 1 5 5
Analog Sticks Yes Yes Yes Yes
Analog Triggers No Yes No Yes
Buttons 24 13 14 13
Rumble No Yes No No

The firmware uses MPG/GP2040 button names:

MPG DInput XInput Switch PS3
B1 1 A B Cross
B2 2 B A Circle
B3 3 X Y Square
B4 4 Y X Triangle
L1 5 LB L L1
R1 6 RB R R1
L2 7 LT ZL L2
R2 8 RT ZR R2
S1 9 Back Minus Select
S2 10 Start Plus Start
L3 11 LS LS L3
R3 12 RS RS R3
A1 13 Guide Home PS
A2 14 - Capture -

Output mode selection during boot:

Output Mode Button Held
Switch B1
XInput B2
PS3 B3

It defaults to Dinput mode.

Xinput mode is not compatible with xbox consoles.

Switch mode is also compatible with ps3 console but without analog trigger.

For usage on MiSTer it's recommended to use it in Dinput mode.
Some special modes will only be activated when in Dinput mode. Like the Guncon mode, and Jogcon as spinner.

Building

One time process: Install the LUFA board definition first. Then select it before building/flashing.

After flashing the device with a LUFA based firmware, you will have to press the reset button to reflash again.
If building the adapter inside a casing, I recommend to leave the reset button accessible.

Copy the contents of _must_copy_to_sketch_folder to the same folder as the arduino sketch file you want to use.

Use the recommended pins for each adapter.

All required libs are included.

For advanced users:
All pins can be customized except the PlayStation DAT, CMD and CLK pins.
The mode selection switch of the Multi adapter must go to an analog pin.

Notes for MiSTer users

For guncon use it's recommended to enable fast usb pooling or the cursor will be laggy.

The bellow steps are only required if using MiSTer Main older than 2024-01-10 or if you change the vid:pid of the device.

If using the default vid:pid, and with a recent MiSTer Main build, it should already work without any further configuration.

If using the arduino's vid:pid, it will require some configuration.

The settings are required for multiple inputs to work on MiSTer.

It's a two step process:

Usb vid:pid

By default it will use RetroZord's usb vid:pid.
This is not available for commercial usage!
Use it on personal projects only. If doing a commercial product, use your own vid:pid.

Credits

For the saturn adapter SaturnLib.
For the snes adapter SnesLib.
For the guncon GunconDuino.

MiSTer-A1 JogCon from JogConUSB by sorgelig.

Jogcon FFB commands from pscontroller-rs by RandomInsano.

PS controller pinout by curiousinventor.

Arduino LUFA by Palatis and CrazyRedMachine.

This uses modified versions of:

MPG by FeralAI.
PsxNewLib by SukkoPera.

Special thanks to my father for the amazing support and for doing all the electronics and soldering stuff.