Permalink
Apr 12, 2019
Mar 1, 2020
Feb 5, 2022
Feb 5, 2022
Apr 12, 2019
Dec 7, 2019
Apr 12, 2019
Mar 1, 2020
Mar 1, 2020
Mar 1, 2020
Mar 1, 2020
Apr 12, 2019
Feb 5, 2022
Nov 10, 2019
Feb 5, 2022
Aug 11, 2019
Sep 20, 2020
Sep 20, 2020
Feb 5, 2022
Aug 12, 2019
Aug 12, 2019
Aug 12, 2019
Aug 12, 2019
Aug 12, 2019
Aug 11, 2019
Aug 11, 2019
Dec 8, 2019
Feb 9, 2020
Dec 14, 2019
Feb 5, 2022
Feb 5, 2022
Feb 5, 2022
Feb 5, 2022
Nov 10, 2019
Aug 11, 2019
Nov 10, 2019
Aug 11, 2019
Aug 11, 2019
Nov 10, 2019
Aug 11, 2019
Feb 5, 2022
Nov 10, 2019
Dec 7, 2019
Dec 31, 2019
Nov 10, 2019
Dec 7, 2019
Nov 7, 2019
Nov 7, 2019
Nov 10, 2019
Nov 8, 2019
Nov 7, 2019
Nov 11, 2019
Aug 11, 2019
Dec 7, 2019
Dec 7, 2019
Apr 23, 2019
Aug 11, 2019
Apr 12, 2019
Apr 12, 2019
Aug 4, 2019
Newer
100644
368 lines (261 sloc)
15.2 KB
2
5
[Supported gamepads]: https://lh3.googleusercontent.com/U1PRr4a21yGffPHxRlONqeolOnr2i-IuONM4ajQksvxB5Lr3zfQFmkHJJbwRNVUY0WrNik5Ia79se3sQx0aa4axuGnBbytyH_5fJnKELX4FOMRM4qrF3bYCmmp0Vk3ZnltQ0YCiRTK0=-no
7
Unijoysticle 2 & 2+ support all the gamepads supported by [Bluepad32][bp32]. For a complete, up-to-date list, see:
10
11
[bp32_supported_gamepads]: https://github.com/ricardoquesada/bluepad32/blob/main/docs/supported_gamepads.md
15
18
All Bluetooth Classic HID controllers are supported, or should be easy to support them.
19
Example of Bluetooth Classic HID controllers are:
20
24
- Nintendo Switch Pro controller (`W`) and clones (`V`)
25
- Nintendo Wii U Pro controller (`U`)
26
- Nintendo Wii Remote (`T`) and Remote Motion Plus (`S`), including Nunchuk (`Q`) and Classic Controller (`R`)
27
- 8BitDo controllers (`I`, `J`, `K`)
28
- Android controllers (`A`, `D`, `E`, `F`)
29
- iCade controllers (`B`, `M`)
30
- Nimbus SteelSeries(`N`)
32
- Some TV remote controls, like the Amazon Fire TV (`H`)
33
- Some mice (`G`)
34
35
[ref-supported-gamepads]: https://lh3.googleusercontent.com/o_oR_kKOLRvXQXHSXgYVNUZ13dpC-6dKV7PLu_8Rq7RmexMTfOLmQspl_3N-htomOyWgf5YQTzex4Y3GOP1QmEVSZdZBNWYCavk_ql5XhU825VHjaisGcTopVx3o7pOCEavvIrrl44s=w200-h222-no
36
50
- *Play* button to swap joystick port
51
- Supported features: rumble, lightbar color, player LEDs
52
- Lightbar color sets color according to assigned port number. Green: port #1, red: port #2, yellow: enhanced mode.
53
54
[dualsense]: https://lh3.googleusercontent.com/pw/ACtC-3d1CVA-e5srBTDhTD6D-3BSWYi7MncfECPj_9bQJfcGOAKIHrP6g6Ha7xAD0trE59eN-Qv_U33MklCFPskPWRLjfFI4ITHEol8RAmTYNHFNrA-gwhoXEn2ks_M7UDDbxiKhNdaPNXexxgj5zzOtpBjiyw=-no
63
- Press:
64
- *X* for Fire
65
- *O* for Jump
66
- *Right shoulder* for Auto-fire
67
- *Play* button to swap joystick port
68
- Lightbar color sets color according to assigned port number. Green: port #1, red: port #2, yellow: enhanced mode.
70
[dualshock_4]: https://lh3.googleusercontent.com/_0sAxKXbSkk4g8rWJzTNxAirz2hD632jW4TGjGVOwjoac8sD4AfiN9PA1HdGWhm_ujcVygDlEG-LENPemF7IyFhqVsHgVHfCMVeFVjBbeDl-fUUjdMbRYAE8FiKdyWM_UBNUNmVy9Ro=-no
77
- Press:
78
- *X* for Fire
79
- *O* for Jump
80
- *Right shoulder* for Auto-fire
81
- *Play* button to swap joystick port
82
- 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.
84
85
[dualshock_3]: https://lh3.googleusercontent.com/pw/ACtC-3dEBJYkdIpF5_icFUY7n7otgw5LPpLyviKS14JL2EJtuiDBt6Kk-XcKlIIP9JCgT0yxJVN1KuW-JICpilYKhMGfDxQt6vjJm8r_lRS1R9IyOX4iBlUQoIrflt9KmSjXBjcJlS81cmKaGB166HF608v5MA=-no
88
## Nintendo Switch Pro
89
90
[![Switch Pro][switch_pro_img]][switch_pro]
91
92
Clones and "licensed by Nintendo" controllers should also work supported Ok.
93
94
- Press:
95
- *B* for Fire
96
- *A* for Jump
97
- *Right shoulder* for Auto-fire
98
- *Home* button to swap joystick port
99
- LEDs #1 and #2 indicates what joystick is being controlled
100
- Home Light turns on when connected
101
102
103
[switch_pro]: https://en.wikipedia.org/wiki/Nintendo_Switch_Pro_Controller
104
[switch_pro_img]: https://lh3.googleusercontent.com/33hrGYM117T9pPrW0L-wr7bl0trLXooqmp4I78XV9vWkumHE8mK8Z_5KJZFzWKNpJg31gvrxHC0agF5BUgVr2f6awNYb98R-xPIWaawG6b0XwxHzm8hzz39Wnnv6qLmeEXsRaeoybsA=-no
105
106
## Nintendo Switch JoyCon
107
108
[![Switch JoyCon][switch_joycon_img]][switch_joycon]
109
110
Both Left and Right JoyCon are supported.
111
112
- Supported features: player LEDs
113
- They must be used in "horizontal" mode.
114
- Each JoyCon represents one gamepad. Cannot be used as a single/combined gamepad.
115
- Some clones are known to work Ok
116
117
[switch_joycon]: https://en.wikipedia.org/wiki/Joy-Con
118
[switch_joycon_img]: https://lh3.googleusercontent.com/pw/ACtC-3cN7JVNm3SvOM3IeKiAg4Ex03Dg7yxozBRNNV95Ycr_0J1eHF03_oDz8ydwpTZCFcPPfFuSzroK4UQ-3KcM0Y2XKew8deuYTqu_q5Q0nEEjA_KTQJCioVRU0IEbBGXHqy2ybtTP7EXp3p-7_RfjYK7Wjg=w360-no
119
120
## Nintendo Wii U Pro controller
121
122
[![Wii U Pro][wii_u_pro]][27]
123
124
- 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.
125
- Press:
126
- *B* for Fire
127
- *A* for Jump
128
- *Right shoulder* for Auto-fire
129
- *Home* button to swap joystick port
130
131
[wii_u_pro]: https://lh3.googleusercontent.com/kfKAySKzV-lLG7VmQGfCES1KuhtjBcTIfMzo59FgABcL7Ir9Tp7fQqrTP2iFqf8UVIhce1JhIXyBN_EH9eXpjlf5Q4b9NhhyxrFX9H0yVVRF0_pghjjz3pVqmY4uxS-FMgr7FC7egNo=w360-no
132
142
- LEDs #1 and #2 indicates what joystick is being controlled.
143
- E.g: If LED #1 is lit, it means that the Wii Remote is controlling Joystick #1.
147
### Sideways mode
148
149
- Default mode. No need to press anything special to enter this mode.
150
- Use Wii Remote in [horiontal position][wii_sideways].
151
- DPAD for regular movements.
152
- Button "1" for fire.
153
- Button "2" for jump.
154
157
- Enter this mode by pressing "A" (A == accelerometer, easy to remember) while connecting or reconnecting.
158
- Tilt up/down for up/down movements
159
- Rotate left/right for left/right movements
160
- Button "A" for fire.
161
- Button "shoulder" to jump.
162
- LED #3 will be on in this mode.
163
164
### Vertical mode
165
167
- DPAD for regular movements.
168
- Button "shoulder" for fire.
169
- Button "A" to jump.
170
- LED #4 will be on in this mode.
171
172
[wii_remote]: https://lh3.googleusercontent.com/HtQgfME-mwm59JFfASHLwHRzvrfesY_FkJTZKfUSAD5XTsPhi-r7Veqvs3n5zr5igm5ug9WmL3rKWuoA7AToeXKIsHpSeMhFRfHfTi53mqu5boTHRtzQSrUex8kHEd8Ny6CS0bpUhEk=w380-no
173
[wii_sideways]: https://forums.dolphin-emu.org/Thread-how-to-hold-the-wii-remote
174
175
## Nintendo Wii Remote + Nunchuk
176
177
[![Wii Remote Nunchuk][wii_nunchuk_img]][wii_nunchuk]
178
179
When Nunchuk is attached to the Wii Remote, the Nunchuk can be used.
180
181
### Nunchuk as regular joystick
182
183
- Default mode. No need to press anything special to enter this mode.
184
- Use Nunchuk joystick for regular movement.
185
- Nunchuck button C for fire.
186
- Nunchuck button Z for jump.
187
188
Wii Remote can also be used, but both of them control the same joystick.
189
190
### Nunchuk as second joystick
191
192
To control both Commodore joysticks (useful when in *Unijoysticle Enhanced mode*), you
193
have to press the "+" button in the Wii Remote while connecting or reconnecting.
194
195
- Enter this mode by pressing button "+" while connecting or reconnecting.
196
- Use Nunchuk joystick for "right" movement.
197
- Nunchuck button C for "right" fire.
198
- Use Wii Remote DPAD for "left" movement.
199
- Use Wii Remote shoulder button for "left" fire.
200
201
[wii_nunchuk_img]: https://lh3.googleusercontent.com/DtCjBt0zrNEDBSgTmaP4BhPlDFfJePFtyBbLvqhEnxG5wjlIjbL1j3akOqbb4_tsSEuVGq1VaBZ_2T94TYNG8tjzxthE-Theo-gphrnG7AW8GEzd7vrmNqjVtGJjDcdhTnkJbsdCCFk=-no
202
[wii_nunchuk]: https://en.wikipedia.org/wiki/Wii_Remote#Nunchuk
203
208
A Nintendo Classic Controller or Classic Controller Pro can be used when it is attached
209
to the Wii Remote. When attached, the Wii Remote will be "disabled" and only the
210
Classic Controller can be used.
211
212
- LEDs #1 and #2 from the Wii Remote indicates what joystick is being controlled.
213
E.g: If LED #1 is lit, it means that the Classic Controller is controlling
214
Joystick #1.
215
- Press:
216
- *B* for Fire
217
- *A* for Jump
218
- *Right shoulder* for Auto-fire
219
- *Home* button to swap joystick port
220
221
[wii_classic_controller_img]: https://lh3.googleusercontent.com/nX-CyjcmorkW90mP8RybO_pJ7ezM4EJk1tsqkz8HAuLkHBAasccZzq5h-A74Ez-h7Zmv5hpsuBu5n66EeThwRUnLTIu8ffk2MstEMBjHiGrcNoyq-XAC9zeh97Kz8GDBDLqmujmm2J0=-no
227
- Must be the *Xbox Wireless Controller model 1708*, model 1797 might work. But versions prior to 1708 and newer than 1797 are not supported.
228
- Supports both "old" and "new" Xbox One mappings: supports firmware v3.1 as well as firmware v4.8.
233
- *Xbox* button to swap joystick port
234
- Supports Force Feedback: it rumbles when it connects to the Unijoysticle device or changes joystick port.
236
[xbox_one_s]: https://lh3.googleusercontent.com/YmONc-MhVZhnE8HVRgzH7FKSpT_29MLeIF70U5AfrcBuCtuNJ2Ln5xkmSpNqO0myrFpnDLbFvR2TRTRu0xcqvP3cLNaq1BBpruEAn-Z7vBbwzNtaXx7eQaLLF7aa8tt2Wa0IcYxeD08=-no
243
- Tested with: [ASUS][15], [Moga Pro 2][16], [Amazon Fire TV gamepads][17], [SteelSeries Status Duo][stratus_duo]
244
- Press:
245
- *A* for Fire
246
- *B* for Jump
247
- *Right shoulder* for Auto-fire
248
- the main/big button in the center (depends on the Android gamepad) to swap joystick port.
250
[android_gamepad]: https://lh3.googleusercontent.com/S3H1pEGYGT5aVTwF3ySWHF7vqbonDYR0UxOLJBxFe5At6Q4AP_4TQUCaNOiEXD22U4H3C0lVP1E3m26H3QM4rIbgp1wysbQoSt1NpD61snlWES5N5zGUgx20c2sfFCKZL4w_Gl66Y1s=-no
258
- Press:
259
- *A* for Fire
260
- *B* for Jump
261
- *Right shoulder* for Auto-fire
262
- *Menu button* to swap joystick port
264
[nimbus_steelseries]: https://lh3.googleusercontent.com/QeK4QebBIw4O-vWuyc-oxTGT_eST6BZ_2y6R9X5cuXPsQVQgZRdm5JEYs982dDKkYDs7AqCIGZyCQBRPJgLJ3ZxNqt_7KYMl9uKkWtmR0P89VbYgC4cMtkEFob2ihA8J6UxGHQ_4Tw0=-no
265
270
- Only 1st gen is supported. It is unknown the status on newer version. They might or might not work.
271
- Press:
272
- *O* for Fire
273
- *A* for JUmp
274
- *Right shoulder* for Auto-fire
275
- *OUYA button* to swap joystick port
278
[ouya_1gen]: https://lh3.googleusercontent.com/FtbQLbt1QrzU59TTPQHIEarGZItlPik0bGWo40iDu0rnMwddCEwKMcy8LAe_fqzklaSKfMbt3-EvFJI4Vcoz3gSPTgC9MnTog3MyGfNWMc0Wq2Idq1kzjPOpRIS5OXeSqSSmIfGa5-w=-no
285
- - Tested with: [8BitDo SN30 Pro][8bitdo_sn30_pro], [8BitDo Arcade Stick][8bitdo_arcade_stick],
286
[8BitDo Lite][8bitdo_lite], [8BitDo NES30][8bitdo_nes30]
288
- Press:
289
- *B* for Fire
290
- *A* for Jump
291
- *Right shoulder* for Auto-fire
295
[8bitdo_sn30_pro_img]: https://lh3.googleusercontent.com/KX3q2kT7UZcEDGN8953RB7msPV343Gworbgaq-eLeKtqSzjTlOIUkoCf0QAf2GrnroQm0ADOCDgj3rK8EWpl2tfqScqExsiSorWZFf7lzA8-m1EoYYkVyjYaeFsSxzcC17kw9CkMNWQ=-no
296
[8bitdo_nes30]: https://www.google.com/search?q=8bitdo+nes30
297
[8bitdo_lite]: https://www.8bitdo.com/lite/
298
[8bitdo_sn30_pro]: https://www.8bitdo.com/sn30-pro-g-classic-or-sn30-pro-sn/
300
[issue_3]: https://gitlab.com/ricardoquesada/unijoysticle2/issues/3
301
[issue_10]: https://gitlab.com/ricardoquesada/unijoysticle2/issues/10
310
- Press:
311
- *Top Left* for Fire
312
- *Bottom Left* for Jump
313
- *Bottom Right* for Auto-fire
314
- *Top Right* button to swap joystick port
315
- Might work with other controllers that support the iCade protocol, but the `uni_hid_device_vendors.h` file might need to be updated.
317
[icade_img]: https://lh3.googleusercontent.com/owslbSElM2BJL5M9h3hqksaCJhjAGf7DyfEwRFxxqjdG3Y73D5V9ScI0zVNokmSJMO6jrHMuX7j437kB-ER7kCAzc8GPX4ir9MPEVdypuxMneoIuzp3yAY8DqvkItbSZY0hlaAUMPn8=-no
318
[icade_url]: https://www.ebay.com/sch/i.html?_from=R40&_trksid=m570.l1313&_nkw=icade+cabinet&_sacat=0&LH_TitleDesc=0&_osacat=0&_odkw=icade+cabinet
319
324
- Press:
325
- *Bottom Left* for Fire
326
- *Bottom Right* for Jump
327
- *Right shoulder* for Auto-fire
328
- *Select* button to swap joystick port
330
[8bitty_img]: https://lh3.googleusercontent.com/LKf4C5SDVlE1mx91vyh8S7AhaJgsgiBZlOuLSVlIKMllSzMbWqOj6lXFmYfPn8fFxBblsXmNyEFVreaJFaxKLjBVTTMhJ2k4Z6C-40c8MSSNCCCokPrhWS_rDQoHtVx01Xckqx-62FI=-no
331
[8bitty_url]: https://www.ebay.com/sch/i.html?_from=R40&_trksid=m570.l1313&_nkw=icade+8-bitty&_sacat=0&LH_TitleDesc=0&_osacat=0&_odkw=icade+8bitty
337
- Only *1st gen* is supported. Apparently *2nd gen* uses BLE instead of BT Classic.
341
[fire_tv_remote]: https://lh3.googleusercontent.com/qnSdv7NM5et0vDhMQsRp7oMniqcjYxGKN9QJY0_gRWT6NXFrdWBf94JKNvP77abBZoykaSQOJBtXUnGW-Z1yF-MWn3q3t2Nt_TUVVV7a2HsPFjRc_DIuLh8tPiQNsEZSWDsb0z6Ys3k=-no
342
347
In general, any Bluetooth Classic (not BLE) controller that supports HID is supported, or should be easy to support it.
349
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.
351
- Select Button + X + Right trigger to enter into Gamepad mode
352
- Select Button + X + Left trigger to enter in iCade mode.
353
354
[generic_gamepad]: https://lh3.googleusercontent.com/JG0sQGQ4lmFIITl_nincUDdPi-mlYPol-RSQrnoxsYZf1_cc16A4WMod_ttuLJoIQigvcZ_ZF6NiA7p54bBQP-Eu52b28mbjfVCwsMjuu_LCQB9Lj0k9e5UkW_PkRM12IB0HrW8ah0k=-no
355
356
357
[1]: https://lh3.googleusercontent.com/sfRd1qSHaxe4he4lt63Xjsr_ejmrthB00bPpIj4CwuUOyzKy3otIrdsPqhy_Y0U78Ibcw5bssuUOgKxNsvhvq6AQGlmigtj2tWA67HQHEaDU4tEmq850Z47rwRW9EzAhFGi6XrgUhUI=-no
358
[13]: https://www.xbox.com/en-US/xbox-one/accessories/controllers/xbox-wireless-controller
359
[14]: https://www.playstation.com/en-us/explore/accessories/gaming-controllers/dualshock-4/
360
[15]: https://www.asus.com/us/Home-Entertainment/Gamepad-TV500BG/
361
[16]: https://www.amazon.com/PowerA-MOGA-Pro-Power-Electronic-Games/dp/B00FB5RBJM?th=1
362
[17]: http://www.gamingonfire.com/2014-amazon-fire-gaming-controller-1st-gen/
363
[18]: https://steelseries.com/gaming-controllers/nimbus
366
[25]: https://www.techradar.com/how-to/gaming/how-to-use-the-ps4-dualshock-4-controller-on-a-pc-1309014
367
[27]: https://en.wikipedia.org/wiki/Wii_U_Pro_Controller