Advanced Controller Framework
Controls_Updater_Menu install guide
Follow this guide to manually add our Controllertools/Controls_Updater_Menu to an existing image.
- Connect to your GPi with SSH (Putty).
- Log in (username pi and pw raspberry)
- you should be at the pi@retropie:~ $ command prompt.
- pi@retropie:~ $ sudo ./RetroPie-Setup/retropie_setup.sh [enter]
- go to manage packages, driver, xboxdrv, install from source.
- It takes 1 hour 15 mins to compile on a raspberry pi zero(w) & 20minutes on a raspberry pi zero 2.
- Exit the setup menu.
Install the Controls Updater Menu
cd && cd RetroPie/retropiemenu && wget -O migrate-controllertools.sh https://raw.githubusercontent.com/SinisterSpatula/Gpi3/master/migrate-controllertools.sh && sudo chmod 775 migrate-controllertools.sh && sudo rm control_updater_menu.sh
- Then run this command
choose Update Controls Framework, then exit.
Switch the D-pad mode of the Gpi case (if you desire, you don’t need to change it, this is just informational):
The Gpi has a hidden option to change the D-PAD mode. To switch to direct input mode, press SELECT+DPAD LEFT for 5 seconds. You will know it worked when the LED flashes. If you need to revert back to facotry D-pad mode: To switch to hat mode (factory) press SELECT+DPAD UP for 5 seconds. It does not matter which mode your d-pad is in for these mappings, they now work with both modes!
If your Gpi is a newer model, the select button was changed to the start button, so select+DPAD LEFT becomes start+DPAD LEFT.
You can get future updates just by doing Option 1 (Update Controls) and option 3 (Update this menu).
Things to keep in mind:
If you have previously setup your key bindings in one of the standalone cores, it is helpful to reset them back to default settings (usually by deleting it’s config file, check the retropie wiki for the core in question to find the config file location). Our controller scripts are based on default bindings. If you want to check if a script has been written for a core, check the script here. Controller Diagrams are located here
- If you have suggestions for improving these control maps, please add your comments or questions here.
For developers who would like to help with mapping, you can find xboxdrv documentation HERE
Useful Testing/development commands: xboxdrv --help, xboxdrv --help-key, xboxdrv --help-all cat /proc/bus/input/devices ls /dev/input/by-id/ (while the emulator is running): evtest /dev/input/event
Default GPi physical gamepad events:
evtest /dev/input/event (Select+left mode) D-pad Up - abs Y- D-pad Down - abs Y+ D-pad Left - abs X- D-pad Right - abs X+ (select+up mode, factory default) D-pad Up - HAT Y- D-pad Down - HAT Y+ D-pad Left - HAT X- D-pad Right - HAT X+ A = BTN_SOUTH B = BTN_EAST X = BTN_NORTH Y = BTN_WEST LB = BTN_TL RB = BTN_TR Select = BTN_SELECT Start = BTN_START ------------------------------------ jstest /dev/input/js0 D-pad Up - Axes 1:-32767 D-pad Down - Axes 1: 32767 D-pad Left - Axes 0:-32767 D-pad Right - Axes 0: 32767 A = 0 B = 1 X = 2 Y = 3 LB = 4 RB = 5 Select = 6 Start = 7