More actions
No edit summary |
No edit summary |
||
(3 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{Infobox WiiU Homebrews | {{Infobox WiiU Homebrews | ||
|title=Bloopair | |title=Bloopair | ||
|image=bloopairwiiu. | |image=bloopairwiiu.png | ||
|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= | |lastupdated=2024/08/17 | ||
|format=rpx, wuhb | |format=rpx, wuhb | ||
|type= | |type=Other Apps | ||
|version=0. | |version=1.0.1 | ||
|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 | * Microsoft Xbox One S/X Controller<br /> | ||
* Sony DualShock 3 Controller | 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 | |||
* 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 == | == 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.1 2024/08/17''' | |||
* Some newer third-party licensed Switch Pro controllers are now supported. These controllers show up as Lic2 Pro Controller, which Bloopair now correctly recognizes as a Switch controller. | |||
* Implemented a workaround for some third-party Switch controllers drifting to the right after connecting. | |||
* Fixed swapped A and B buttons on WiiMotes in Koopair. | |||
'''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 "Gamepad" 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 "Gamepad" 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 108: | ||
'''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 115: | ||
'''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&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&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 137: | ||
'''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 150: | ||
'''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 157: | ||
'''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 162: | ||
'''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. |
Latest revision as of 02:36, 18 August 2024
Bloopair | |
---|---|
General | |
Author | GaryOderNichts |
Type | Other Apps |
Version | 1.0.1 |
License | GPL-2.0 |
Last Updated | 2024/08/17 |
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.1 2024/08/17
- Some newer third-party licensed Switch Pro controllers are now supported. These controllers show up as Lic2 Pro Controller, which Bloopair now correctly recognizes as a Switch controller.
- Implemented a workaround for some third-party Switch controllers drifting to the right after connecting.
- Fixed swapped A and B buttons on WiiMotes in Koopair.
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
- GitHub - https://github.com/GaryOderNichts/Bloopair
- ForTheUsers - https://hb-app.store/wiiu/Bloopair
- ForTheUsers - https://hb-app.store/wiiu/Bloopair-Tiramisu