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