Skip to content

Controllers

The controllers

Controller Player order Connection
Logitech RumblePad 2 1 USB
8BitDo SN30 Pro+ 2 Bluetooth, or USB cable
8BitDo Zero 2 (blue) 3 Bluetooth
8BitDo Zero 2 (yellow) 4 Bluetooth
Keyboard (PC) 1, with the player 1 controller USB

The face buttons, by position:

Controller Bottom Right Left Top
8BitDo SN30 Pro+, 8BitDo Zero 2 B A Y X
Logitech RumblePad 2 2 3 1 4

The face buttons of the controllers

Which button a game means by "press A" on each console: see the Buttons tab of its console page.

The keyboard as a controller (PC)

RetroArch's default keys, for player 1:

Button Where on the controller Key
D-pad Arrow keys
B Bottom Z
A Right X
Y Left A
X Top S
L / R Shoulders Q / W
Select / Start Middle Right Shift / Enter

Note

No L2, R2 or sticks on the keyboard: no turbo (R2) and no N64 C-buttons. The keyboard shortcuts: see In game.

8BitDo: the start mode picks the device

An 8BitDo keeps one Bluetooth pairing per mode, so the buttons held to switch it on choose the device it connects to:

Device Mode Switch on with
PC, phone, tablet D-input B + Start
Raspberry Pi X-input X + Start
Connection How
Bluetooth, Pi (X-input) It reconnects on its own: the Pi is the only device in this mode
Bluetooth, PC, phone, tablet (D-input) The three share one pairing: pair it again when moving to another of them
USB cable Switch it on first, in the right mode (B + Start or X + Start), until it lights up; then plug in the cable

Where the shortcuts are set

Select is the hotkey of every shortcut (Select + X: the menu, Select + L / R: save / load a state...). The shortcuts, the keyboard keys and their limits, while playing: see In game.

Each controller has a profile, read by RetroArch when it recognises the controller: its buttons and its shortcuts.

Device Shortcuts set in Profiles folder
PC each controller's profile (Input → Hotkeys left empty: a value there would replace every profile's) C:\RetroArch-Win64\autoconfig\dinput\: 8BitDo_SN30_Pro+_BT.cfg (Bluetooth), 8BitDo_SN30_Pro+_USB.cfg (cable), 8BitDo_Zero2_gamepad_BT.cfg, Logitech RumblePad 2 USB.cfg
Phone, tablet Settings → Input → Hotkeys (saved in retroarch.cfg) inside the app, out of reach
Raspberry Pi each controller's profile \\RETROPIE\configs\all\retroarch-joypads\ (rewritten by Configure Input in EmulationStation)

Why the PC and Android differ

In D-input mode, each controller has its own button numbers on the PC: the shortcuts must be set per controller, in its profile. Android gives the same numbers to every controller, so one set of hotkeys works for all.

A PC profile is a text file: edit it in Notepad, with RetroArch closed.

The buttons in a profile

Each button has a RetroArch value, the same on every controller (remaps use it: input_player1_btn_b = "8" means the bottom button sends A), and the controller's own number, written in its profile. The PC's numbers (D-input), with the printed label in brackets:

RetroArch value Line 8BitDo SN30 Pro+ 8BitDo Zero 2 Logitech RumblePad 2
0 (bottom) input_b_btn "1" (B) "1" (B) "1" (2)
8 (right) input_a_btn "0" (A) "0" (A) "2" (3)
1 (left) input_y_btn "4" (Y) "4" (Y) "0" (1)
9 (top) input_x_btn "3" (X) "3" (X) "3" (4)
10 / 11 input_l_btn / input_r_btn "6" / "7" (L / R) "6" / "7" (L / R) "4" / "5" (5 / 6)
12 / 13 input_l2_btn / input_r2_btn "8" / "9" (L2 / R2) - "6" / "7" (7 / 8)
14 / 15 input_l3_btn / input_r3_btn "13" / "14" (LS / RS) - "10" / "11"
2 / 3 input_select_btn / input_start_btn "10" / "11" (Select / Start) "10" / "11" (Select / Start) "8" / "9" (9 / 10)
4 (D-pad up) input_up_btn (Zero 2: input_up_axis) "h0up" "-1" "h0up"
5 (D-pad down) input_down_btn (Zero 2: input_down_axis) "h0down" "+1" "h0down"
6 (D-pad left) input_left_btn (Zero 2: input_left_axis) "h0left" "-0" "h0left"
7 (D-pad right) input_right_btn (Zero 2: input_right_axis) "h0right" "+0" "h0right"
Left stick up / down input_l_y_minus_axis / _plus_axis "-1" / "+1" - "-1" / "+1"
Left stick left / right input_l_x_minus_axis / _plus_axis "-0" / "+0" - "-0" / "+0"
Right stick up / down input_r_y_minus_axis / _plus_axis "-5" / "+5" - "-5" / "+5"
Right stick left / right input_r_x_minus_axis / _plus_axis "-2" / "+2" - "-2" / "+2"

The Zero 2's D-pad is read as a stick (axis lines), and it has no L2, R2 or sticks.

The shortcut lines in a profile

The same button numbers, PC (D-input):

Shortcut Line 8BitDo SN30 Pro+ 8BitDo Zero 2 Logitech RumblePad 2
Select: the hotkey input_enable_hotkey_btn "10" "10" "8"
Select + X: menu input_menu_toggle_btn "3" "3" "3"
Select + Start: close the game input_close_content_btn "11" "11" "9"
Select + L: save a state input_save_state_btn "6" "6" "4"
Select + R: load a state input_load_state_btn "7" "7" "5"
Select + D-pad left / right: state slot input_state_slot_decrease_btn / _increase_btn "h0left" / "h0right" (axis, below) "h0left" / "h0right"
Select + D-pad left / right (Zero 2) input_state_slot_decrease_axis / _increase_axis - "-0" / "+0" -
Select + R2: fast-forward input_toggle_fast_forward_btn "9" - (no R2) "7"