Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Bloopair Wii U: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 4: Line 4:
|description=Allows connecting controllers from other consoles like native Wii U Pro Controllers on the Wii U.   
|description=Allows connecting controllers from other consoles like native Wii U Pro Controllers on the Wii U.   
|author=GaryOderNichts   
|author=GaryOderNichts   
|lastupdated=2023/02/07  
|lastupdated=2024/07/20  
|format=rpx, wuhb     
|format=rpx, wuhb     
|type=Other Apps
|type=Other Apps
|version=0.6.2  
|version=1.0.0  
|license=GPL-2.0   
|license=GPL-2.0   
|download=https://dlhb.gamebrew.org/wiiuhomebrews/bloopairwiiu.7z   
|download=https://dlhb.gamebrew.org/wiiuhomebrews/bloopairwiiu.7z   
Line 19: Line 19:
    
    
Supported controllers:   
Supported controllers:   
* Nintendo Switch Pro Controller
* Nintendo Switch Pro Controller
* Nintendo Switch Joy-Con
* Nintendo Switch Joy-Con
* Nintendo Switch Online SNES/N64 Controller
* Nintendo Switch Online SNES / N64 Controller
* Microsoft Xbox One S/X Controller (excluding latest firmware and Series S/X Controllers).
* Microsoft Xbox One S/X Controller<br />
* Sony DualShock 3 Controller (with USB pairing).
Note: The latest firmware versions and all Series S/X Controllers are currently not supported due to missing Bluetooth LE support.
* Sony DualShock 4 Controller
* Sony DualShock 3 Controller<br />
* Sony DualSense Controller
To pair a DualShock 3 to the console, see the [https://github.com/GaryOderNichts/Bloopair#pairing-a-dualshock-3 Pairing a DualShock 3] section.
 
* Sony DualShock 4 Controller
== Features == 
* Sony DualSense Controller
* Connect up to 7 controllers wirelessly via Bluetooth. 
* Rumble support. 
* Battery levels. 
    
    
== Features ==
* Connect up to 7 controllers wirelessly via Bluetooth
* Rumble support
* Battery levels
* Button and stick remapping (only for Bloopair controllers)
== Installation ==   
== Installation ==   
Aroma:   
Aroma:   
Line 47: Line 50:
    
    
Wait for the controller to connect. Reconnect past controllers by turning them on.   
Wait for the controller to connect. Reconnect past controllers by turning them on.   
 
 
===Koopair===
Koopair is the Bloopair companion app which comes with Bloopair.
 
'''Koopair supports:'''
* Testing connected controllers
* Creating mappings for buttons and sticks
* Editing controller options
* Managing configuration files
* Pairing DualShock 3 controllers
 
=== Pairing a DualShock 3 ===   
=== Pairing a DualShock 3 ===   
Open Bloopair pairing app from Wii U menu or Homebrew Launcher.   
Open Bloopair pairing app from Wii U menu or Homebrew Launcher.   
Line 61: Line 74:
For Tiramisu or Aroma only (v0.5.X onwards).   
For Tiramisu or Aroma only (v0.5.X onwards).   
    
    
== Changelog ==   
== Changelog ==
'''v1.0.0 2024/07/20'''  
* Bloopair now features a configuration system, which can load controller options and button mappings from the SD Card.
** Sticks can be mapped as buttons and buttons can be mapped as sticks.
** Stick axes can be inverted.
** Every button/stick can be mapped to multiple buttons/sticks on both ends.
** Configurations can either be applied to a specific controller or to all controllers of a specific type.
** Configurations are stored under <code>wiiu/bloopair</code> on the SD Card.
* A new Bloopair companion app is now bundled with the release: Koopair!<br />
Koopair can:
** Test controller buttons and sticks using the built-in controller tester.
** Edit and create controller mappings.
** Edit controller options.
** Manage saved controller configurations.
** Pair DualShock3 controllers over USB. The old pairing app has been deprecated and removed from releases in favor of Koopair.
* and much more to come in the near future...
 
'''v0.6.2 2023/02/07'''   
'''v0.6.2 2023/02/07'''   
 
* Fixes an issue where Wii Remotes and other controllers without the &quot;Gamepad&quot; device class could no longer be paired to the console, while Bloopair v0.6.X was active (closes [https://github.com/GaryOderNichts/Bloopair/issues/89 #89]).   
* Fixes an issue where Wii Remotes and other controllers without the &quot;Gamepad&quot; device class could no longer be paired to the console, while Bloopair v0.6.X was active (closes [https://github.com/GaryOderNichts/Bloopair/issues/89 #89]).   
* Finally fixes an issue where some third-party Wii Remotes weren't able to be paired to the console (closes [https://github.com/GaryOderNichts/Bloopair/issues/56 #56]).   
* Finally fixes an issue where some third-party Wii Remotes weren't able to be paired to the console (closes [https://github.com/GaryOderNichts/Bloopair/issues/56 #56]).   
    
    
'''v0.6.1 2023/01/29'''   
'''v0.6.1 2023/01/29'''   
 
* '''Switch Controller''':   
* '''Switch Controller''':   
** User calibration data is now properly read for the right stick.   
** User calibration data is now properly read for the right stick.   
Line 76: Line 103:
    
    
'''v0.6.0 2023/01/27'''   
'''v0.6.0 2023/01/27'''   
 
* A lot of code has been refactored to improve stability and maintainability.   
* A lot of code has been refactored to improve stability and maintainability.   
* Avoid stick drifting which rarely happened once a controller was connected.   
* Avoid stick drifting which rarely happened once a controller was connected.   
Line 84: Line 110:
    
    
'''v0.5.3 2022/09/06'''   
'''v0.5.3 2022/09/06'''   
 
* The Dualshock 3 pairing menu is now available as a .wuhb (Wii U homebrew bundle).   
* The Dualshock 3 pairing menu is now available as a .wuhb (Wii U homebrew bundle).   
* Adjusted switch rumble values to feel more like a Wii U Pro Controller.   
* Adjusted switch rumble values to feel more like a Wii U Pro Controller.   
    
    
'''v0.5.2 2022/04/05'''   
'''v0.5.2 2022/04/05'''   
 
* Fix rumble issues with 8BitDo controllers running in Xbox mode.   
* Fix rumble issues with 8BitDo controllers running in Xbox mode.   
    
    
'''v0.5.1 2022/01/19'''   
'''v0.5.1 2022/01/19'''   
 
* DualSense controllers now report the correct battery levels.   
* DualSense controllers now report the correct battery levels.   
* Fixed the report length when pairing a DualShock 3, this hopefully fixes pairing some third-party controllers.   
* Fixed the report length when pairing a DualShock 3, this hopefully fixes pairing some third-party controllers.   
    
    
'''v0.5.0-tiramisu2 2022/01/02'''   
'''v0.5.0-tiramisu2 2022/01/02'''   
 
* This release fixes an issue that caused Bloopair to fail when running Tiramisu through the Browser exploit.   
* This release fixes an issue that caused Bloopair to fail when running Tiramisu through the Browser exploit.   
    
    
'''v0.5.0-tiramisu 2022/01/01'''   
'''v0.5.0-tiramisu 2022/01/01'''   
 
* Note: There is currently an issue when loading Bloopair through the browser exploit. To fix this only copy the Bloopair files to the SD after you've installed the PayloadLoader into H&amp;S.   
* Note: There is currently an issue when loading Bloopair through the browser exploit. To fix this only copy the Bloopair files to the SD after you've installed the PayloadLoader into H&amp;S.   
    
    
'''v0.5.0 2021/11/24'''   
'''v0.5.0 2021/11/24'''   
 
* Support was added for third-party Switch controllers which don't have a valid Vendor and Product ID.   
* Support was added for third-party Switch controllers which don't have a valid Vendor and Product ID.   
* Player LED patterns for the DualSense were updated to match the patterns of Wii U Pro Controllers.   
* Player LED patterns for the DualSense were updated to match the patterns of Wii U Pro Controllers.   
Line 112: Line 132:
    
    
'''v0.4.1 2021/11/08'''   
'''v0.4.1 2021/11/08'''   
 
* Fix the stick buttons being swapped on the Nintendo Switch Pro Controller. That bug was introduced with v0.4.0.   
* Fix the stick buttons being swapped on the Nintendo Switch Pro Controller. That bug was introduced with v0.4.0.   
    
    
'''v0.4.0 2021/11/08'''   
'''v0.4.0 2021/11/08'''   
 
* Nintendo Switch Controllers:   
* Nintendo Switch Controllers:   
** Use the extended reports, this fixes an issue with the button mapping of third-party controllers.   
** Use the extended reports, this fixes an issue with the button mapping of third-party controllers.   
Line 127: Line 145:
    
    
'''v0.3.0 2021/10/11'''   
'''v0.3.0 2021/10/11'''   
 
* Added support for the Sony DualShock 3.   
* Added support for the Sony DualShock 3.   
Read the [https://github.com/GaryOderNichts/Bloopair#pairing-a-dualshock-3 Pairing a DualShock 3] section for pairing instructions.   
Read the [https://github.com/GaryOderNichts/Bloopair#pairing-a-dualshock-3 Pairing a DualShock 3] section for pairing instructions.   
Line 135: Line 152:
    
    
'''v0.2.0 2021/09/30'''   
'''v0.2.0 2021/09/30'''   
 
* Reworked the internal pairing process and made connections more stable.   
* Reworked the internal pairing process and made connections more stable.   
* Sony Dualshock 4 support.   
* Sony Dualshock 4 support.   
Line 141: Line 157:
    
    
'''v0.1.0 2021/09/19'''   
'''v0.1.0 2021/09/19'''   
 
* This is an initial release of Bloopair, refer to the [https://github.com/GaryOderNichts/Bloopair README] for more info.   
* This is an initial release of Bloopair, refer to the [https://github.com/GaryOderNichts/Bloopair README] for more info.   
* If you find any issues or bugs, please report them.   
* If you find any issues or bugs, please report them.   

Revision as of 02:12, 21 July 2024

Bloopair
Bloopairwiiu.png
General
AuthorGaryOderNichts
TypeOther Apps
Version1.0.0
LicenseGPL-2.0
Last Updated2024/07/20
Links
Download
Website
Source
Support Author

Bloopair enables connection of various controllers to the Wii U, such as native Wii U Pro Controllers, by applying temporary patches to the IOS-PAD module for Bluetooth connections.

Supported controllers:

  • Nintendo Switch Pro Controller
  • Nintendo Switch Joy-Con
  • Nintendo Switch Online SNES / N64 Controller
  • Microsoft Xbox One S/X Controller

Note: The latest firmware versions and all Series S/X Controllers are currently not supported due to missing Bluetooth LE support.

  • Sony DualShock 3 Controller

To pair a DualShock 3 to the console, see the Pairing a DualShock 3 section.

  • Sony DualShock 4 Controller
  • Sony DualSense Controller

Features

  • Connect up to 7 controllers wirelessly via Bluetooth
  • Rumble support
  • Battery levels
  • Button and stick remapping (only for Bloopair controllers)

Installation

Aroma:

  • Copy 30_bloopair.rpx to sd:/wiiu/environments/aroma/modules/setup/.
  • Copy the wiiu folder to the root of your SD Card.

Tiramisu:

  • Copy 30_bloopair.rpx to sd:/wiiu/environments/tiramisu/modules/setup/.
  • Copy the wiiu folder to the root of your SD Card.

For Mocha/Haxchi/CBHC, you can try version 0.5.0 instead.

User guide

Boot into Tiramisu and the Wii U menu, then press SYNC on both the console and controller.

Wait for the controller to connect. Reconnect past controllers by turning them on.

Koopair

Koopair is the Bloopair companion app which comes with Bloopair.

Koopair supports:

  • Testing connected controllers
  • Creating mappings for buttons and sticks
  • Editing controller options
  • Managing configuration files
  • Pairing DualShock 3 controllers

Pairing a DualShock 3

Open Bloopair pairing app from Wii U menu or Homebrew Launcher.

Connect DualShock 3 via USB cable, then press PS button on the Wii U menu to complete pairing. Press the Home button to exit.

Troubleshooting

If controllers don't pair, ensure Bloopair is running, both devices are in SYNC mode, and check the supported list. Restart if needed.

You can also try clearing controller syncs.

Compatibility

For Tiramisu or Aroma only (v0.5.X onwards).

Changelog

v1.0.0 2024/07/20

  • Bloopair now features a configuration system, which can load controller options and button mappings from the SD Card.
    • Sticks can be mapped as buttons and buttons can be mapped as sticks.
    • Stick axes can be inverted.
    • Every button/stick can be mapped to multiple buttons/sticks on both ends.
    • Configurations can either be applied to a specific controller or to all controllers of a specific type.
    • Configurations are stored under wiiu/bloopair on the SD Card.
  • A new Bloopair companion app is now bundled with the release: Koopair!

Koopair can:

    • Test controller buttons and sticks using the built-in controller tester.
    • Edit and create controller mappings.
    • Edit controller options.
    • Manage saved controller configurations.
    • Pair DualShock3 controllers over USB. The old pairing app has been deprecated and removed from releases in favor of Koopair.
  • and much more to come in the near future...

v0.6.2 2023/02/07

  • Fixes an issue where Wii Remotes and other controllers without the "Gamepad" device class could no longer be paired to the console, while Bloopair v0.6.X was active (closes #89).
  • Finally fixes an issue where some third-party Wii Remotes weren't able to be paired to the console (closes #56).

v0.6.1 2023/01/29

  • Switch Controller:
    • User calibration data is now properly read for the right stick.
    • Third-party Pro controllers now use the extended reports.

This fixes an issue where the capture button wasn't mapped and calibration data ignored.

    • Properly handle cases where no calibration data is stored on the controller at all.

v0.6.0 2023/01/27

  • A lot of code has been refactored to improve stability and maintainability.
  • Avoid stick drifting which rarely happened once a controller was connected.
  • Switch Controller:
    • User calibration data is now used if available (after calibrating a controller using a Switch).
    • The capture button is now mapped to an unused button bit, which can be accessed by homebrew applications.

v0.5.3 2022/09/06

  • The Dualshock 3 pairing menu is now available as a .wuhb (Wii U homebrew bundle).
  • Adjusted switch rumble values to feel more like a Wii U Pro Controller.

v0.5.2 2022/04/05

  • Fix rumble issues with 8BitDo controllers running in Xbox mode.

v0.5.1 2022/01/19

  • DualSense controllers now report the correct battery levels.
  • Fixed the report length when pairing a DualShock 3, this hopefully fixes pairing some third-party controllers.

v0.5.0-tiramisu2 2022/01/02

  • This release fixes an issue that caused Bloopair to fail when running Tiramisu through the Browser exploit.

v0.5.0-tiramisu 2022/01/01

  • Note: There is currently an issue when loading Bloopair through the browser exploit. To fix this only copy the Bloopair files to the SD after you've installed the PayloadLoader into H&S.

v0.5.0 2021/11/24

  • Support was added for third-party Switch controllers which don't have a valid Vendor and Product ID.
  • Player LED patterns for the DualSense were updated to match the patterns of Wii U Pro Controllers.
  • Bloopair now properly supports up to 7 controllers in supported games (e.g. Super Smash Bros. Wii U).

v0.4.1 2021/11/08

  • Fix the stick buttons being swapped on the Nintendo Switch Pro Controller. That bug was introduced with v0.4.0.

v0.4.0 2021/11/08

  • Nintendo Switch Controllers:
    • Use the extended reports, this fixes an issue with the button mapping of third-party controllers.
    • Use the factory analog stick calibration.
    • Support rumble for the Joy-Cons.
    • Support battery levels.
    • Support the Nintendo Switch Online N64 controllers.
  • Support battery levels of DualShock 3 controllers.
  • Bloopair now disconnects all connected controllers before patching IOS-PAD, this avoids an issue with "zombie controllers" being stuck in a controller slot.

v0.3.0 2021/10/11

  • Added support for the Sony DualShock 3.

Read the Pairing a DualShock 3 section for pairing instructions.

  • Fix some weird stick behavior with third-party Switch controllers.
  • Bloopair will now detect if it's already running.

This avoids undefined behavior when launching Bloopair more than once.

v0.2.0 2021/09/30

  • Reworked the internal pairing process and made connections more stable.
  • Sony Dualshock 4 support.
  • Nintendo Switch SNES Controller support.

v0.1.0 2021/09/19

  • This is an initial release of Bloopair, refer to the README for more info.
  • If you find any issues or bugs, please report them.

External links

Advertising: