RetroPie forum home
    • Recent
    • Tags
    • Popular
    • Home
    • Docs
    • Register
    • Login
    Please do not post a support request without first reading and following the advice in https://retropie.org.uk/forum/topic/3/read-this-first

    Guide: Advanced Controller Mappings

    Scheduled Pinned Locked Moved Help and Support
    joystickcontrollermappingxboxdrvscummvm
    626 Posts 35 Posters 461.4k Views
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • mediamogulM
      mediamogul Global Moderator @spud11
      last edited by mediamogul

      @spud11 said in Guide: Advanced Controller Mappings:

      it produced a similar error as above but the string2btn() line changed to the following:

      I've never tried to void the dpad, but I do know thatdpad_x=void and dpad_y=void aren't valid entries for --ui-buttonmap. However, I believe you might be able to void them under --ui-axismap such as:

      --ui-axismap dpad_x=void,dpad_y=void
      

      If that doesn't work, you might try omitting them from the configuration altogether.

      RetroPie v4.5 • RPi3 Model B • 5.1V 2.5A PSU • 16GB SanDisk microSD • 512GB External Drive

      S 2 Replies Last reply Reply Quote 0
      • S
        spud11 @mediamogul
        last edited by

        @mediamogul Thanks. I'll try both options when I'm home and let you know how I go.

        RetroPie v4.4.1 • RPi3 Model B • 5.1V 2.5A PSU • 32GB SanDisk Extreme microSD • 2TB Toshiba Canvio Basics Portable USB 3.0 hard drive • 4 x DragonRise USB Arcade joysticks • 2 x TurboTwist spinners • 1 x USB trackball • 1 x PS4 wireless • 1 x 8BitDo Zero

        1 Reply Last reply Reply Quote 0
        • S
          spud11 @mediamogul
          last edited by

          @mediamogul Hi. Thanks so much. The code without the --ui-axismap did the trick. I've set it out below for anyone who has a Zero Delay Arcade Encoder. For sake of completeness, I've attached an image of the encoder too.

          sudo /opt/retropie/supplementary/xboxdrv/bin/xboxdrv \
          --evdev /dev/input/by-id/usb-DragonRise_Inc._Generic_USB_Joystick-event-joystick \
          --silent \
          --detach-kernel-driver \
          --force-feedback \
          --deadzone-trigger 15% \
          --deadzone 4000 \
          --trigger-as-button \
          --mimic-xpad \
          --device-name "8-Way Arcade Joystick" \
          --evdev-absmap ABS_X=x1,ABS_RX=y1 \
          --evdev-keymap BTN_TRIGGER=a,BTN_THUMB=b,BTN_THUMB2=x,BTN_TOP=y,BTN_BASE2=back,BTN_BASE5=start \
          --ui-buttonmap lb=void,rb=void,tl=void,tr=void,guide=void,lt=void,rt=void \
          &
          

          Again, thanks so much, mediamogul. I couldn't have done it without your help. I'm now in the process of trying to change the arcade joystick to port 0 (rather than it defaulting to the DragonRise).0_1476787083532_Joystick.PNG .

          RetroPie v4.4.1 • RPi3 Model B • 5.1V 2.5A PSU • 32GB SanDisk Extreme microSD • 2TB Toshiba Canvio Basics Portable USB 3.0 hard drive • 4 x DragonRise USB Arcade joysticks • 2 x TurboTwist spinners • 1 x USB trackball • 1 x PS4 wireless • 1 x 8BitDo Zero

          1 Reply Last reply Reply Quote 1
          • W
            weirdocollector
            last edited by weirdocollector

            Hi again.

            I'm finally back to my RetroPie, ands I'm still struggling with the xboxdrv drive configuration, that continues to refuse to work as expected.

            I've applied all the suggested syntax modifications to my /opt/retropie/configs/all/runcommand-onstart.sh, which is the now the following:

            #!/bin/sh
            ## Uncomment one or all of the following if you need to find some information about the emulator or roms
            ## Name of the emulator
            echo $1 >> /dev/shm/runcommand.log
            
            ## Name of the software used for running the emulation
            echo $2 >> /dev/shm/runcommand.log
            
            ## Name of the rom
            #echo $3 >> /dev/shm/runcommand.log
            
            ##Executed command line
            echo $4 >> /dev/shm/runcommand.log
            
            
            ### The FUN begins
            #Get ROM name striping full path
            rom="${3##*/}"
            
            ### Set variables for your joypad and emulator
            ### Basic Configurations - Standard controller mappings
            XboxOne="/opt/retropie/supplementary/xboxdrv/bin/xboxdrv \
                --evdev /dev/input/by-id/usb-Microsoft_Controller_7EED8E7D89A9-event-joystick \
                --silent \
                --detach-kernel-driver \
                --force-feedback \
                --deadzone-trigger 15% \
                --deadzone 4000 \
                --mimic-xpad \
                --trigger-as-button \
                --evdev-absmap ABS_X=x1,ABS_Y=y1,ABS_RX=x2,ABS_RY=y2,ABS_HAT0X=dpad_x,ABS_HAT0Y=dpad_y \
                --evdev-keymap ABS_HAT0X-=du,ABS_HAT0X+=dd,ABS_HAT0Y-=dl,ABS_HAT0Y+=dr \	
                --evdev-keymap BTN_SOUTH=a,BTN_EAST=b,BTN_NORTH=x,BTN_WEST=y,BTN_TL=lb,BTN_TR=rb,BTN_TL2=lt,BTN_TR2=rt,BTN_THUMBL=tl,BTN_THUMBR=tr,BTN_MODE=guide,BTN_SELECT=back,BTN_START=start"
            
            ### Extended Configurations
            ### Specific emulator configuration or any other parameters you will need only for some emulators
            atari800="--axismap -Y1=Y1,-Y2=Y2 \
            	--dpad-as-button \
                --evdev-keymap ABS_HAT0X-=du,ABS_HAT0X+=dd,ABS_HAT0Y-=dl,ABS_HAT0Y+=dr \
            	--ui-axismap X1=KEY_KP4:KEY_KP6,Y1=KEY_KP8:KEY_KP5 \
            	--ui-axismap X2=KEY_1:KEY_2,Y2=KEY_3:KEY_4,lt+X2=KEY_5:KEY_6,lt+Y2=KEY_7:KEY_8,rt+X2=KEY_9:KEY_0,rt+Y2=KEY_KPASTERISK:KEY_EQUAL \
            	--ui-buttonmap a=KEY_RIGHTCTRL,b=KEY_F2,x=KEY_EQUAL,y=KEY_KPASTERISK,lb=KEY_F9,rb=KEY_F5,du=KEY_KP8,dd=KEY_KP5,dl=KEY_KP4,dr=KEY_KP6,start=KEY_F4,back=KEY_F3,lt=KEY_HOME,rt=KEY_HOME,tl=KEY_HOME,tr=KEY_HOME \
            	--ui-buttonmap lt+a=KEY_ENTER,lt+b=KEY_ESC,lt+du=KEY_UP,lt+dd=KEY_DOWN,lt+dl=KEY_LEFT,lt+dr=KEY_RIGHT,lt+start=KEY_F1 \
            	--ui-axismap lt+X1=KEY_LEFT:KEY_RIGHT,lt+Y1=KEY_UP:KEY_DOWN \
            	--ui-buttonmap guide=void"
            
            fourway="--four-way-restrictor"
            
            invert="--ui-buttonmap du=KEY_DOWN,dd=KEY_UP"
            
            ### Kill Command
            xboxkill="sudo killall >/dev/null xboxdrv"
            
            ### Execute the driver with the configuration you need
            # $1 is the name of the emulation, not the name of the software used
            # it is intellivision not jzintv
            case $1 in
            
            	atari800)
                    $xboxkill
                    joycommand="$XboxOne $atari800 &"
                    eval $joycommand
                ;;
            esac
            

            As you may have noticed, I've uncommented some of the lines at the start of the script, in order to get the runcommand.log file, and getting some hints about what's wrong with it.

            I've rebooted my Pi, but I got no runcommand.log file into the /dev/shm/ directory; I've also tried to run directly the script with ./runcommand-onstart.sh, and I got an empty runcommand.log file.

            What am I doing wrong ?

            Thanks for any help.

            1 Reply Last reply Reply Quote 0
            • W
              weirdocollector
              last edited by weirdocollector

              Hi again!

              I've made some progress.

              Launching the script ./runcommand-onstart.sh atari800, I get the following error message:

              -- [ ERROR ] ------------------------------------------------------ error: invalid argument '--evdev-absmap ABS_HAT0X-=du,ABS_HAT0X+=dd,ABS_HAT0Y-=dl,ABS_HAT0Y+=dr' string2axis(): couldn't convert string "du" to XboxAxis

              The problem seems to be that I do not know how to map the Xbox One controller hat (that is considered an analog input), to the du, dd, dl, dr keys.

              Do someone know how the correct mapping can be done ?

              I've looked at the xboxdrv documentation, but I couldn't extrapolate anything useful.

              mediamogulM 1 Reply Last reply Reply Quote 0
              • mediamogulM
                mediamogul Global Moderator @weirdocollector
                last edited by mediamogul

                @weirdocollector

                The error is from du, dd, dl, dr being used in --evdev-absmap. du, dd, dl, dr can only be used with --ui-buttonmap alongside --dpad-as-button.

                RetroPie v4.5 • RPi3 Model B • 5.1V 2.5A PSU • 16GB SanDisk microSD • 512GB External Drive

                W 1 Reply Last reply Reply Quote 1
                • P
                  Pyjamarama
                  last edited by

                  @mediamogul You do a terrific job. I have gone through your guide many times but without success.

                  I think I mess up in the rc.local

                  The evtest displays lots of entries when a press a button and lots lots lots :) when I move a stick or analog trigger.

                  So I think my problem lies in how to populate the rc.local from the results of evtest

                  Can you post me your rc.local ?

                  I think I can get an idea reading yours and evtesting my retropie.

                  Thank you!

                  1 Reply Last reply Reply Quote 0
                  • W
                    weirdocollector @mediamogul
                    last edited by weirdocollector

                    @mediamogul

                    Hi,

                    I've tried the following:

                    --ui-buttonmap du=ABS_HAT0X-, dd=ABS_HAT0X+, dl= ABS_HAT0Y-, dr=ABS_HAT0Y+

                    preceded by alongside --dpad-as-button, but it still get an error.

                    How can I map the hat (seen as an analog input) to the dd, du, dl, dr keys ?

                    Thanks for any help.

                    mediamogulM 1 Reply Last reply Reply Quote 0
                    • mediamogulM
                      mediamogul Global Moderator
                      last edited by mediamogul

                      @Pyjamarama said in Guide: Advanced Controller Mappings:

                      The evtest displays lots of entries when a press a button and lots lots lots

                      This also happens with one of my controllers. In my case it meant that the axis input was so sensitive that it was being activated whenever any button was pressed. To prevent this from carrying over to the virtual controller, I had to add the --deadzone 4000. However, you'll still need a way to discern the actual button information from all the extra information you're given in evtest. This takes a bit of work, as you'll have to barely tap each button and then scroll up to the very top of the resulting input and see what the first listing was before all the garbage.

                      RetroPie v4.5 • RPi3 Model B • 5.1V 2.5A PSU • 16GB SanDisk microSD • 512GB External Drive

                      1 Reply Last reply Reply Quote 2
                      • mediamogulM
                        mediamogul Global Moderator @weirdocollector
                        last edited by

                        @weirdocollector said in Guide: Advanced Controller Mappings:

                        How can I map the hat

                        Mapping the dpad hatswitch from a physical controller to the xboxdrv virtual controller is done as follows:

                        --evdev-absmap ABS_HAT0X=dpad_x,ABS_HAT0Y=dpad_y
                        

                        From there you would normally map keys to it like any other axis:

                        --ui-axismap dpad_x=KEY_LEFT:KEY_RIGHT,dpad_y=KEY_UP:KEY_DOWN
                        

                        However, if you want to the dpad to be seen as button presses rather than an axis with the new virtual controller, you would add:

                        --dpad-as-button
                        

                        Once this has been added you can now key-map the dpad with --ui-buttonmap such as:

                        --ui-buttonmap du=KEY_UP,dd=KEY_DOWN,dl=KEY_LEFT,dr=KEY_RIGHT
                        

                        RetroPie v4.5 • RPi3 Model B • 5.1V 2.5A PSU • 16GB SanDisk microSD • 512GB External Drive

                        W 1 Reply Last reply Reply Quote 2
                        • W
                          weirdocollector @mediamogul
                          last edited by weirdocollector

                          @mediamogul

                          Thanks mediamomogul!

                          Now the script works, but I have another problem.

                          If I enter the Atari5200 emulator, the controller commands doesn't work, but if I go to my SSH console and I type (in the /opt/retropie/configs/all directory) ./runcommand-onstart.sh atari800 + Return, while the emulator is running, the controller starts working as expected (yay!).

                          It seems that the script is finally correct, but it doesn't seem to start when the atari emulator il launched.

                          Am I forgetting something ?

                          mediamogulM 1 Reply Last reply Reply Quote 0
                          • mediamogulM
                            mediamogul Global Moderator @weirdocollector
                            last edited by

                            @weirdocollector

                            I'm afraid I'll have to defer this question to @MadHorse, who has a better understanding of this area. In the mean time, go ahead and post the full contents of your runcommand-onstart.sh file and I'll see if anything jumps out.

                            RetroPie v4.5 • RPi3 Model B • 5.1V 2.5A PSU • 16GB SanDisk microSD • 512GB External Drive

                            W 1 Reply Last reply Reply Quote 0
                            • W
                              weirdocollector @mediamogul
                              last edited by weirdocollector

                              @mediamogul

                              Thanks !

                              Here is my runcommand-onstart.sh script:

                              #!/bin/sh
                              ## Uncomment one or all of the following if you need to find some information about the emulator or roms
                              ## Name of the emulator
                              echo $1 >> /dev/shm/runcommand.log
                              
                              ## Name of the software used for running the emulation
                              echo $2 >> /dev/shm/runcommand.log
                              
                              ## Name of the rom
                              echo $3 >> /dev/shm/runcommand.log
                              
                              ##Executed command line
                              echo $4 >> /dev/shm/runcommand.log
                              
                              
                              ### The FUN begins
                              #Get ROM name striping full path
                              rom="${3##*/}"
                              
                              ### Set variables for your joypad and emulator
                              ### Basic Configurations - Standard controller mappings
                              XboxOne="/opt/retropie/supplementary/xboxdrv/bin/xboxdrv \
                                  --evdev /dev/input/by-id/usb-Microsoft_Controller_7EED8E7D89A9-event-joystick \
                                  --silent \
                                  --detach-kernel-driver \
                                  --force-feedback \
                                  --deadzone-trigger 15% \
                                  --deadzone 4000 \
                                  --mimic-xpad \
                                  --trigger-as-button \
                                  --evdev-absmap ABS_X=x1,ABS_Y=y1,ABS_RX=x2,ABS_RY=y2,ABS_HAT0X=dpad_x,ABS_HAT0Y=dpad_y \
                                  --evdev-keymap BTN_SOUTH=a,BTN_EAST=b,BTN_NORTH=x,BTN_WEST=y,BTN_TL=lb,BTN_TR=rb,BTN_TL2=lt,BTN_TR2=rt,BTN_THUMBL=tl,BTN_THUMBR=tr,BTN_MODE=guide,BTN_SELECT=back,BTN_START=start"
                              	
                              ### Extended Configurations
                              ### Specific emulator configuration or any other parameters you will need only for some emulators
                              atari800="--axismap -Y1=Y1,-Y2=Y2 \
                              	--dpad-as-button \
                              	--ui-axismap X1=KEY_KP4:KEY_KP6,Y1=KEY_KP8:KEY_KP5 \
                              	--ui-axismap X2=KEY_1:KEY_2,Y2=KEY_3:KEY_4,lt+X2=KEY_5:KEY_6,lt+Y2=KEY_7:KEY_8,rt+X2=KEY_9:KEY_0,rt+Y2=KEY_KPASTERISK:KEY_EQUAL \
                              	--ui-buttonmap a=KEY_RIGHTCTRL,b=KEY_F2,x=KEY_EQUAL,y=KEY_KPASTERISK,lb=KEY_F9,rb=KEY_F5,du=KEY_KP8,dd=KEY_KP5,dl=KEY_KP4,dr=KEY_KP6,start=KEY_F4,back=KEY_F3,lt=KEY_HOME,rt=KEY_HOME,tl=KEY_HOME,tr=KEY_HOME \
                              	--ui-buttonmap lt+a=KEY_ENTER,lt+b=KEY_ESC,lt+du=KEY_UP,lt+dd=KEY_DOWN,lt+dl=KEY_LEFT,lt+dr=KEY_RIGHT,lt+start=KEY_F1 \
                              	--ui-axismap lt+X1=KEY_LEFT:KEY_RIGHT,lt+Y1=KEY_UP:KEY_DOWN \
                              	--ui-buttonmap guide=void"
                              
                              fourway="--four-way-restrictor"
                              
                              invert="--ui-buttonmap du=KEY_DOWN,dd=KEY_UP"
                              
                              ### Kill Command
                              xboxkill="sudo killall >/dev/null xboxdrv"
                              
                              ### Execute the driver with the configuration you need
                              # $1 is the name of the emulation, not the name of the software used
                              # it is intellivision not jzintv
                              case $1 in
                              
                              	atari800)
                                      $xboxkill
                                      joycommand="$XboxOne $atari800 &"
                                      eval $joycommand
                                  ;;
                              
                              esac
                              

                              Thanks for any help !

                              1 Reply Last reply Reply Quote 0
                              • W
                                weirdocollector
                                last edited by

                                Ok, I've found the problem...

                                The runcommand-onstart.sh script passes as first parameters ($1) the string atari5200, and not the string atari800, making the case into the script to skip the execution of the driver.

                                In my script I've changed all the occurrances of atari800 into atari5200and it now works !!

                                Thanks to everybody for all the help !

                                mediamogulM 1 Reply Last reply Reply Quote 2
                                • mediamogulM
                                  mediamogul Global Moderator @weirdocollector
                                  last edited by mediamogul

                                  @weirdocollector

                                  Well done sir! Case scripting is an area that I haven't had time to fully explore yet, so these posts are always very informative.

                                  RetroPie v4.5 • RPi3 Model B • 5.1V 2.5A PSU • 16GB SanDisk microSD • 512GB External Drive

                                  meleuM 1 Reply Last reply Reply Quote 0
                                  • meleuM
                                    meleu @mediamogul
                                    last edited by meleu

                                    @mediamogul sorry for acting like a lazy guy here, but can you share with us a way to set only one button to act like pressing two buttons?

                                    The goal is to put a button on a bartop to do "exit emulator" function (usually start+select).

                                    Thanks in advance.

                                    • Useful topics
                                    • joystick-selection tool
                                    • rpie-art tool
                                    • achievements I made
                                    mediamogulM 1 Reply Last reply Reply Quote 1
                                    • mediamogulM
                                      mediamogul Global Moderator @meleu
                                      last edited by mediamogul

                                      @meleu

                                      Not a problem. Let's say that the keyboard key you're looking to map to 'start+select' is the 'Escape' key. Also, we'll assume that 'Back' is being used as a stand-in for 'Select', due to the lack of a 'Select' button option on the virtual XBox controller. The mapping would read as:

                                      --ui-buttonmap back+start=KEY_ESC
                                      

                                      If you ever run into software that uses a key combination to exit, such as 'ctrl+escape', the alteration is nothing more complicated than:

                                      --ui-buttonmap back+start=KEY_LEFTCTRL+KEY_ESC
                                      

                                      or possibly:

                                      --ui-buttonmap back+start=KEY_RIGHTCTRL+KEY_ESC
                                      

                                      RetroPie v4.5 • RPi3 Model B • 5.1V 2.5A PSU • 16GB SanDisk microSD • 512GB External Drive

                                      1 Reply Last reply Reply Quote 2
                                      • P
                                        PolluxNL
                                        last edited by

                                        -Is it possible to use xboxdrv with a PS3 controller?
                                        -Should I disable/remove PS3 Bluetooth driver?
                                        -Should I try configuring it wireless or connected?

                                        And "ls /dev/input/by-id/" doesn't work.

                                        Any help is welcome.

                                        Thanks in advance!

                                        mediamogulM 1 Reply Last reply Reply Quote 0
                                        • mediamogulM
                                          mediamogul Global Moderator @PolluxNL
                                          last edited by mediamogul

                                          @PolluxNL said in Guide: Advanced Controller Mappings:

                                          -Is it possible to use xboxdrv with a PS3 controller?

                                          It is indeed.

                                          -Should I disable/remove PS3 Bluetooth driver?

                                          I can't really say, but it's likely that it will conflict otherwise.

                                          -Should I try configuring it wireless or connected?

                                          I believe problems arise when configured wirelessly, due to the bluetooth connection being dropped when sleeping.

                                          And "ls /dev/input/by-id/" doesn't work.

                                          you can also use it's joystick event number at /dev/input/jsX, where x is likely to be 0.

                                          RetroPie v4.5 • RPi3 Model B • 5.1V 2.5A PSU • 16GB SanDisk microSD • 512GB External Drive

                                          1 Reply Last reply Reply Quote 0
                                          • Capt_MorganCreekC
                                            Capt_MorganCreek
                                            last edited by

                                            Hi mediamogul!
                                            Your guide is really comprehensive, thank you!

                                            I got the basics, but xboxdrv gives me trouble using the calibration parameter.

                                            If I don't calibrate my controller the output from the control stick is to low to be useful.

                                            If I use --calibration x1=40:128:207,y1=50:128:207 \ (in my case an adapted N64 controller) the stick returns higher values, but it almost behaves like a button jumping between the min and max values (32767/-32767) with nothing inbetween.

                                            Is there another way to increase the analog output? Maybe just multipling the original values by a factor of 2 would do the trick but I have no idea how to approach this idea and I can't get my head around the filtering concept.

                                            I'm really looking forward to a solution, this is really a showstopper for my usecase.

                                            These are my settings:

                                            sudo /opt/retropie/supplementary/xboxdrv/bin/xboxdrv
                                            --evdev /dev/input/event2
                                            --silent
                                            --detach-kernel-driver
                                            --force-feedback
                                            --deadzone-trigger 15%
                                            --deadzone 15%
                                            --device-name "N64 Player 1"
                                            --evdev-absmap ABS_X=x1,ABS_Y=y1,ABS_RZ=x2,ABS_Z=y2,ABS_HAT0X=dpad_x,ABS_HAT0Y=dpad_y
                                            --evdev-keymap BTN_THUMB=a,BTN_THUMB2=b,BTN_BASE=lb,BTN_BASE2=rb,BTN_BASE3=tl,BTN_BASE4=start
                                            --ui-axismap lt=void,rt=void
                                            --ui-buttonmap tr=void,guide=void,back=void,x=void,y=void
                                            --calibration x1=40:128:207,y1=50:128:207 \

                                            RetroPie64 - My Nintendo 64 conversion: https://retropie.org.uk/forum/post/55927

                                            mediamogulM 1 Reply Last reply Reply Quote 0
                                            • First post
                                              Last post

                                            Contributions to the project are always appreciated, so if you would like to support us with a donation you can do so here.

                                            Hosting provided by Mythic-Beasts. See the Hosting Information page for more information.