supported_gamepads.md

Supported controllers

Unijoysticle 2 & 2+ support all the gamepads supported by Bluepad32. For a complete, up-to-date list, see:

• Bluepad32 supported gamepads <-- UP TO DATE LIST

Bluetooth Classic: Supported

All Bluetooth Classic HID controllers are supported, or should be easy to support them. Example of Bluetooth Classic HID controllers are:

• Xbox Wireless controller (L)
• DUALSHOCK 4 controller, both 2013 (P) and 2016 (O) editions
• DUALSHOCK 3 controller
• Nintendo Switch Pro controller (W) and clones (V)
• Nintendo Wii U Pro controller (U)
• Nintendo Wii Remote (T) and Remote Motion Plus (S), including Nunchuk (Q) and Classic Controller (R)
• 8BitDo controllers (I, J, K)
• Android controllers (A, D, E, F)
• iCade controllers (B, M)
• Nimbus SteelSeries(N)
• OUYA controllers (C)
• Some TV remote controls, like the Amazon Fire TV (H)
• Some mice (G)

Tested gamepads

Tested gamepads so far.

Sony DualSense (PS5)

[][11]

• Must be in PC mode
• Press:
  • X for Fire
  • O for Jump
  • Right shoulder for Auto-fire
  • Play button to swap joystick port
• Supported features: rumble, lightbar color, player LEDs
• Lightbar color sets color according to assigned port number. Green: port #1, red: port #2, yellow: enhanced mode.

DUALSHOCK 4

• Must be in PC mode. Clones might not work.
• Supports both the 2013 and 2016 editions
• Press:
  • X for Fire
  • O for Jump
  • Right shoulder for Auto-fire
  • Play button to swap joystick port
• Lightbar color sets color according to assigned port number. Green: port #1, red: port #2, yellow: enhanced mode.

DUALSHOCK 3

• Tested with genuine DS3. Clones might not work.
• Press:
  • X for Fire
  • O for Jump
  • Right shoulder for Auto-fire
  • Play button to swap joystick port
• LEDs #1 and #2 indicates what joystick is being controlled. E.g: If LED #1 is lit, it means that the gamepad is controlling Joystick #1.
• Requires that the DS3 is manually paired to the Unijoysticle device.

Nintendo Switch Pro

Clones and "licensed by Nintendo" controllers should also work supported Ok.

• Press:
  • B for Fire
  • A for Jump
  • Right shoulder for Auto-fire
  • Home button to swap joystick port
• LEDs #1 and #2 indicates what joystick is being controlled
• Home Light turns on when connected

Nintendo Switch JoyCon

Both Left and Right JoyCon are supported.

• Supported features: player LEDs
• They must be used in "horizontal" mode.
• Each JoyCon represents one gamepad. Cannot be used as a single/combined gamepad.
• Some clones are known to work Ok

Nintendo Wii U Pro controller

• LEDs #1 and #2 indicates what joystick is being controlled. E.g: If LED #1 is lit, it means that the gamepad is controlling Joystick #1.
• Press:
  • B for Fire
  • A for Jump
  • Right shoulder for Auto-fire
  • Home button to swap joystick port

Nintendo Wii Remote

• Supports both Wii Remote and Wii Remote Motion Plus.
• Supports 3 modes:
  • Sideways mode (default)
  • Accelerometer mode
  • Vertical mode
• LEDs #1 and #2 indicates what joystick is being controlled.
  • E.g: If LED #1 is lit, it means that the Wii Remote is controlling Joystick #1.
• Press Home button to swap joystick port
• To start pairing, use the "Sync" method (press "Sync" button).

Sideways mode

• Default mode. No need to press anything special to enter this mode.
• Use Wii Remote in horiontal position.
• DPAD for regular movements.
• Button "1" for fire.
• Button "2" for jump.

Accelerometer mode

• Enter this mode by pressing "A" (A == accelerometer, easy to remember) while connecting or reconnecting.
• Tilt up/down for up/down movements
• Rotate left/right for left/right movements
• Button "A" for fire.
• Button "shoulder" to jump.
• LED #3 will be on in this mode.

Vertical mode

• Enter this mode by pressing button "+" while connecting or reconnecting.
• DPAD for regular movements.
• Button "shoulder" for fire.
• Button "A" to jump.
• LED #4 will be on in this mode.

Nintendo Wii Remote + Nunchuk

When Nunchuk is attached to the Wii Remote, the Nunchuk can be used.

Nunchuk as regular joystick

• Default mode. No need to press anything special to enter this mode.
• Use Nunchuk joystick for regular movement.
• Nunchuck button C for fire.
• Nunchuck button Z for jump.

Wii Remote can also be used, but both of them control the same joystick.

Nunchuk as second joystick

To control both Commodore joysticks (useful when in Unijoysticle Enhanced mode), you have to press the "+" button in the Wii Remote while connecting or reconnecting.

• Enter this mode by pressing button "+" while connecting or reconnecting.
• Use Nunchuk joystick for "right" movement.
• Nunchuck button C for "right" fire.
• Use Wii Remote DPAD for "left" movement.
• Use Wii Remote shoulder button for "left" fire.

Nintendo Wii Remote + Classic Controller / Classic Controller Pro

A Nintendo Classic Controller or Classic Controller Pro can be used when it is attached to the Wii Remote. When attached, the Wii Remote will be "disabled" and only the Classic Controller can be used.

• LEDs #1 and #2 from the Wii Remote indicates what joystick is being controlled. E.g: If LED #1 is lit, it means that the Classic Controller is controlling Joystick #1.
• Press:
  • B for Fire
  • A for Jump
  • Right shoulder for Auto-fire
  • Home button to swap joystick port

Xbox Wireless controller (model 1708)

• Must be the Xbox Wireless Controller model 1708, model 1797 might work. But versions prior to 1708 and newer than 1797 are not supported.
• Supports both "old" and "new" Xbox One mappings: supports firmware v3.1 as well as firmware v4.8.
• Press:
  • A for Fire
  • B for Jump
  • Right shoulder for Auto-fire
  • Xbox button to swap joystick port
• Supports Force Feedback: it rumbles when it connects to the Unijoysticle device or changes joystick port.

Android

• Tested with: ASUS, Moga Pro 2, Amazon Fire TV gamepads, SteelSeries Status Duo
• Press:
  • A for Fire
  • B for Jump
  • Right shoulder for Auto-fire
  • the main/big button in the center (depends on the Android gamepad) to swap joystick port.

Nimbus SteelSeries

• Tested with Nimbus SteelSeries for iOS.
• Press:
  • A for Fire
  • B for Jump
  • Right shoulder for Auto-fire
  • Menu button to swap joystick port

OUYA

• Only 1st gen is supported. It is unknown the status on newer version. They might or might not work.
• Press:
  • O for Fire
  • A for JUmp
  • Right shoulder for Auto-fire
  • OUYA button to swap joystick port
• Known issues: issue #7

8BitDo Family

• • Tested with: 8BitDo SN30 Pro, 8BitDo Arcade Stick, 8BitDo Lite, 8BitDo NES30
• All 8BitDo modes are supported: Switch, Android, Windows and macOS.
• Press:
  • B for Fire
  • A for Jump
  • Right shoulder for Auto-fire
  • Start (or Home) to swap joystick port (depends on the 8Bitdo controller)
• Known issues: issue #10

iCade Family

iCade Cabinet

• The original iCade cabinets works great.
• Press:
  • Top Left for Fire
  • Bottom Left for Jump
  • Bottom Right for Auto-fire
  • Top Right button to swap joystick port
• Might work with other controllers that support the iCade protocol, but the uni_hid_device_vendors.h file might need to be updated.

iCade 8-bitty

• Press:
  • Bottom Left for Fire
  • Bottom Right for Jump
  • Right shoulder for Auto-fire
  • Select button to swap joystick port

Amazon Fire TV Remote

• Only 1st gen is supported. Apparently 2nd gen uses BLE instead of BT Classic.
• Press:
  • Home button to swap joystick port

Generic HID controllers

In general, any Bluetooth Classic (not BLE) controller that supports HID is supported, or should be easy to support it.

There many generic Bluetooth controllers that sometimes are offered as gifts in conferences. Usually these generic Bluetooth controllers have different connection modes. Use the HID one.

• Select Button + X + Right trigger to enter into Gamepad mode
• Select Button + X + Left trigger to enter in iCade mode.