From 7ccd9fb63dfd07f9f3e4a50a02ce5bbc71b8250a Mon Sep 17 00:00:00 2001 From: laz Date: Sun, 23 Mar 2025 12:24:49 +0100 Subject: [PATCH] merge wii --- .../wiki_controllers/nintendo/wii-remote.md | 111 +---------- .../dolphin-bluetooth-pass.png | Bin .../dolphin-connect-scan.png | Bin .../dolphin-primehack-guide.md | 177 +++++++++++++++++- .../dolphin-primehack}/emulated-bluetooth.png | Bin 5 files changed, 175 insertions(+), 113 deletions(-) rename wiki-rtd/docs/{wiki_images/emulators/dolphin => wiki_emulator_guides/dolphin-primehack}/dolphin-bluetooth-pass.png (100%) rename wiki-rtd/docs/{wiki_images/emulators/dolphin => wiki_emulator_guides/dolphin-primehack}/dolphin-connect-scan.png (100%) rename wiki-rtd/docs/{wiki_images/emulators/dolphin => wiki_emulator_guides/dolphin-primehack}/emulated-bluetooth.png (100%) diff --git a/wiki-rtd/docs/wiki_controllers/nintendo/wii-remote.md b/wiki-rtd/docs/wiki_controllers/nintendo/wii-remote.md index 5c2d2b4..ed54bd4 100644 --- a/wiki-rtd/docs/wiki_controllers/nintendo/wii-remote.md +++ b/wiki-rtd/docs/wiki_controllers/nintendo/wii-remote.md @@ -39,7 +39,6 @@ Many third party Wii Remotes lack native Linux support, but several groups are w [bluez: issue 94](https://github.com/bluez/bluez/issues/94) - ## RetroDECK: Sync Wiimote Button Hotkey RetroDECK has a built-in hotkey for pressing the Dolphin `Sync Wiimote` button (`Alt + W`) if you get disconnected. It can also be accessed from some controller's radial menu systems, like on the Steam Deck. @@ -64,116 +63,8 @@ RetroDECK has a built-in hotkey for pressing the Dolphin `Sync Wiimote` button ( - A Wii Sensor Bar alternative (wireless or wired). - A Linux compatible Bluetooth dongle or built-in Bluetooth adapter. -### Mod: Wii bluetooth adapter to USB +## Mod: Wii bluetooth adapter to USB For hardware mod enthusiasts, you can buy a Bluetooth adapter spare part from a Wii console and wire it as a USB Bluetooth adapter for better compatibility. [How to wire a Wii's Bluetooth Module to a PC USB Port](https://forums.dolphin-emu.org/Thread-how-to-wire-a-wii-s-bluetooth-module-to-a-pc-usb-port) - - -## How-to: Configure Dolphin - Method 1: Emulate Wii's Bluetooth Adapter - -This method works only with the Official Wii Remote controller and is the easiest method. - -### Step 1: Open Dolphins Controller Settings - - - -Open `RetroDECK Configurator` -> `Open Emulator` -> `Dolphin` -> `Options` -> `Controller Settings`. - - -### Step 2: Change the Settings - -Under `Emulate the Wii's Bluetooth adapter`: - -- Change the values of Wii Remote dropdown lists from `Emulated Wii Remote` to `Real Wii Remote`. -- Enable the following checkboxes: - - `Connect Wii Remotes for Emulated Controllers` - - `Continuous Scanning` - -### Step 3: Syncing the Wiimotes - -- Connect the Wiimote by pressing the `Sync Button` when a game is launched. -- Reconnect every time when launching a new game. If everything works, re-pairing should be quick with the press of the `A` button without needing to press the `Sync Button` again. - - -## How-to: Configure Dolphin - Method 2: Bluetooth Passthrough - - -This method works with both 3rd party and official Wiimotes. It is more complex and has some downsides. - -**🛑 Warning 🛑** - -This method makes the Bluetooth adapter unusable for other devices while playing Wii games. No other devices can connect to it except Wiimotes, meaning all other devices will disconnect. -It is recommended to have a backup input method like a wireless keyboard or a controller with a dongle/cable. - -Source: [Dolphin Wiki: Bluetooth_Passthrough](https://wiki.dolphin-emu.org/index.php?title=Bluetooth_Passthrough) - -### Step 1: Find Your Vendor and Product IDs - -First you need to find our your `Vendor ID` `Product ID` for the Bluetooth adapter you want to use. - -1. Open a terminal window. -2. Type `lsusb`. -3. It will display all connected USB or BUS devices. - -**Example:** - -``` -Bus 001 Device 003: ID 0bda:5650 Realtek Semiconductor Corp. -Bus 001 Device 004: ID 8087:0025 Intel Corp. Wireless-AC 9260 Bluetooth Adapter -``` - -`ID 8087:0025 Intel Corp. Wireless-AC 9260 Bluetooth Adapter` is the Bluetooth Adapter in this example. The `ID 8087:0025` left value is the `Vendor ID` while the right is `Product ID`. In this example: `Vendor ID` is `8087` and `Product ID` is `0025`. - - -### Step 2: Create the rules file - -You will need root privileges for this. - - -1. Open a terminal and type the following command, replacing `Vendor ID` and `Product ID` respectively: - -``` -sudo echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="Vendor ID", ATTRS{idProduct}=="Product ID", TAG+="uaccess"' | sudo tee -a /etc/udev/rules.d/52-dolphin.rules > /dev/null -``` - -From the example above, the result should look like this: - -``` -sudo echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="8087", ATTRS{idProduct}=="0025", TAG+="uaccess"' | sudo tee -a /etc/udev/rules.d/52-dolphin.rules > /dev/null -``` - -2. Reload udev rules with: sudo udevadm control --reload-rules. -3. Take out and reinsert the Bluetooth adapter or reboot if a built-in was used. - -### Step 3: Enable Bluetooth Passthrough in Dolphin - -Open `RetroDECK Configurator` -> `Open Emulator` -> `Dolphin` -> `Options` -> `Controller Settings`. - - - -Change Bluetooth type: - -- From `Emulate the Wii's Bluetooth adapter` to `Passthrough a Bluetooth Adapter` - -Enable the following checkboxes: - - - -- `Connect Wii Remotes for Emulated Controllers` -- `Continuous Scanning` - -### Step 4: Syncing the Wiimotes - -- Connect the Wiimote when a game is launched. -- Reconnect every time when launching a new game. -- Press `1` and `2` together on the Wiimote or the `Sync Button` (under the backplate) when launching a game. -- Sometimes, press the `Sync Button` on the Emulated Wii in the Dolphin Interface. RetroDECK has a built-in shortcut for this (`Alt + W`), accessible from the Steam Input Radial Menu system. - -### Extra: Troubleshooting and Tips - -- Sit close to the device during initial pairing. -- Pairing may take a while, especially with third-party Wiimotes. Try multiple times with the `Sync Button` + `Sync Wiimote`. -- To play with normal controllers again, change back to `Emulate the Wii's Bluetooth adapter` setting and `Emulated Wii Remote`. -- If the udev rules created in Step 2 are incorrect and Dolphin cannot get Bluetooth access, it will display an error message and crash. Ensure the file in `/etc/udev/rules.d/52-dolphin.rules` and its content are correct. diff --git a/wiki-rtd/docs/wiki_images/emulators/dolphin/dolphin-bluetooth-pass.png b/wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/dolphin-bluetooth-pass.png similarity index 100% rename from wiki-rtd/docs/wiki_images/emulators/dolphin/dolphin-bluetooth-pass.png rename to wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/dolphin-bluetooth-pass.png diff --git a/wiki-rtd/docs/wiki_images/emulators/dolphin/dolphin-connect-scan.png b/wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/dolphin-connect-scan.png similarity index 100% rename from wiki-rtd/docs/wiki_images/emulators/dolphin/dolphin-connect-scan.png rename to wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/dolphin-connect-scan.png diff --git a/wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/dolphin-primehack-guide.md b/wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/dolphin-primehack-guide.md index 68c5aee..330ef87 100644 --- a/wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/dolphin-primehack-guide.md +++ b/wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/dolphin-primehack-guide.md @@ -120,6 +120,8 @@ This shows what folder corresponds to each folder in the standard PrimeHack stru | Texture Packs | `retrodeck/mods/Primehack/` | `var/data/primehack/Load/Textures/` | `primehack/Load/Textures/` | | | Wii Saves | `retrodeck/saves/wii/primehack/` | `var/data/primehack/Wii/` | `primehack/Wii/` | | +--- + ## Where do I change the language of Dolphin / Primehack? 1. In the `Configurator` open either `Dolphin` or `Primehack`. @@ -193,11 +195,173 @@ Tilt emulation is made possible by holding the `L2` button and moving the `Right -## How-to: Use a Real Wii Remote with Dolphin / Primehack? +--- -To get a Wii Remote working on Dolphin / Primehack and Linux read more here in this in-depth guide: +## Information: Using Real Wii Remotes -[Wii Remote - Guide](../../wiki_controllers/nintendo/wii-remote.md) +**Tip:** Sync Wiimote Button Hotkey + +RetroDECK has a built-in hotkey for pressing the Dolphin `Sync Wiimote` button (`Alt + W`) if you get disconnected in Steam Input. It can also be accessed from some controller's radial menu systems. + +### Hardware Prerequisites + + + +- A Wii Sensor Bar alternative (wireless or wired). +- A Linux compatible Bluetooth dongle or built-in Bluetooth adapter. + +### On Third Party Wii Remotes + +Many third party Wii Remotes lack native Linux support, but several groups are working on it. + +- They may work with Bluetooth Passthrough mode in Dolphin. +- They may or may not remember pairing with the Bluetooth adapter, requiring synchronization for each game. + +**Sources:** + +[xwiimote github](https://github.com/xwiimote/xwiimote) + +[xwiimote-ng github](https://github.com/dev-0x7C6/xwiimote-ng) - Fork of xwiimote + +**Related Issues:** + +[xwiimote: issue 66](https://github.com/xwiimote/xwiimote/issues/66) + +[xwiimote: issue 73](https://github.com/xwiimote/xwiimote/issues/73) + +[bluez: issue 94](https://github.com/bluez/bluez/issues/94) + +### Steam Deck Tips: Real Wii Remotes + +- Play docked, connected to a monitor/TV, with a separate Bluetooth dongle attached to the dock. +- Set a sudo password for the Steam Deck. +- Connect a keyboard/mouse to the dock while setting up. +- Sit close to the Steam Deck when pairing the Wiimotes. +- Configure Wiimotes in `Desktop Mode` first, then switch to `Game Mode` when everything is working. + + - Open Dolphin from the Configurator. + - Make all the settings changes to connect the Wiimotes. + - Launch a game from `Desktop Mode` directly in Dolphin. + - If pairing works and the Wiimotes connect and control the game fine in `Desktop Mode`, it will work in `Game Mode` when launched from RetroDECK. + +### Mod: Wii bluetooth adapter to USB + +For hardware mod enthusiasts, you can buy a Bluetooth adapter spare part from a Wii console and wire it as a USB Bluetooth adapter for better compatibility. + +[How to wire a Wii's Bluetooth Module to a PC USB Port](https://forums.dolphin-emu.org/Thread-how-to-wire-a-wii-s-bluetooth-module-to-a-pc-usb-port) + +--- + +## How-to: Use a Real Wii Remote - Method 1: Emulate Wii's Bluetooth Adapter + +This method works only with the Official Wii Remote controller and is the easiest method. + +### Step 1: Open Dolphins Controller Settings + + + +Open `RetroDECK Configurator` -> `Open Emulator` -> `Dolphin` -> `Options` -> `Controller Settings`. + + +### Step 2: Change the Settings + +Under `Emulate the Wii's Bluetooth adapter`: + +- Change the values of Wii Remote dropdown lists from `Emulated Wii Remote` to `Real Wii Remote`. +- Enable the following checkboxes: + - `Connect Wii Remotes for Emulated Controllers` + - `Continuous Scanning` + +### Step 3: Syncing the Wiimotes + +- Connect the Wiimote by pressing the `Sync Button` when a game is launched. +- Reconnect every time when launching a new game. +- If everything works, re-pairing should be quick with the press of the `A` button without needing to press the `Sync Button` again. + +--- + +## How-to: Use a Real Wii Remote - Method 2: Bluetooth Passthrough + +This method works with both 3rd party and official Wiimotes. It is more complex and has some downsides. + +**🛑 Warning 🛑** + +- This method makes the Bluetooth adapter unusable for other devices while playing Wii games. +- No other devices can connect to it except Wiimotes, meaning all other devices will disconnect. +- It is recommended to have a backup input method like a wireless keyboard or a controller with a dongle/cable. + +Source: [Dolphin Wiki: Bluetooth_Passthrough](https://wiki.dolphin-emu.org/index.php?title=Bluetooth_Passthrough) + +### Step 1: Find Your Vendor and Product IDs + +First you need to find our your `Vendor ID` `Product ID` for the Bluetooth adapter you want to use. + +1. Open a terminal window. +2. Type `lsusb`. +3. It will display all connected USB or BUS devices. + +**Example:** + +``` +Bus 001 Device 003: ID 0bda:5650 Realtek Semiconductor Corp. +Bus 001 Device 004: ID 8087:0025 Intel Corp. Wireless-AC 9260 Bluetooth Adapter +``` + +`ID 8087:0025 Intel Corp. Wireless-AC 9260 Bluetooth Adapter` is the Bluetooth Adapter in this example. The `ID 8087:0025` left value is the `Vendor ID` while the right is `Product ID`. In this example: `Vendor ID` is `8087` and `Product ID` is `0025`. + + +### Step 2: Create the rules file + +You will need root privileges for this. + + +1. Open a terminal and type the following command, replacing `Vendor ID` and `Product ID` respectively: + +``` +sudo echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="Vendor ID", ATTRS{idProduct}=="Product ID", TAG+="uaccess"' | sudo tee -a /etc/udev/rules.d/52-dolphin.rules > /dev/null +``` + +From the example above, the result should look like this: + +``` +sudo echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="8087", ATTRS{idProduct}=="0025", TAG+="uaccess"' | sudo tee -a /etc/udev/rules.d/52-dolphin.rules > /dev/null +``` + +2. Reload udev rules with: sudo udevadm control --reload-rules. +3. Take out and reinsert the Bluetooth adapter or reboot if a built-in was used. + +### Step 3: Enable Bluetooth Passthrough in Dolphin + +Open `RetroDECK Configurator` -> `Open Emulator` -> `Dolphin` -> `Options` -> `Controller Settings`. + + + +Change Bluetooth type: + +- From `Emulate the Wii's Bluetooth adapter` to `Passthrough a Bluetooth Adapter` + +Enable the following checkboxes: + + + +- `Connect Wii Remotes for Emulated Controllers` +- `Continuous Scanning` + +### Step 4: Syncing the Wiimotes + +- Connect the Wiimote when a game is launched. +- Reconnect every time when launching a new game. +- Press `1` and `2` together on the Wiimote or the `Sync Button` (under the backplate) when launching a game. +- Sometimes, press the `Sync Button` on the Emulated Wii in the Dolphin Interface. RetroDECK has a built-in shortcut for this (`Alt + W`), accessible from the Steam Input Radial Menu system. + +### Extra: Troubleshooting and Tips + +- Sit close to the device during initial pairing. +- Pairing may take a while, especially with third-party Wiimotes. Try multiple times with the `Sync Button` + `Sync Wiimote`. +- To play with normal controllers again, change back to `Emulate the Wii's Bluetooth adapter` setting and `Emulated Wii Remote`. +- If the udev rules created in Step 2 are incorrect and Dolphin cannot get Bluetooth access, it will display an error message and crash. Ensure the file in `/etc/udev/rules.d/52-dolphin.rules` and its content are correct. + +--- ## How-to: Add Mods @@ -230,6 +394,8 @@ Make sure you have the right game and textures for it. If all is correct the mods should be loaded on next game launch. +--- + ## How-to: Add Texture Packs? Primehack is based on Dolphin so the method is the same. @@ -259,9 +425,14 @@ Some texture packs could made for a specific version or region of a game. Make s If all is correct the textures should be loaded on next game launch. + +--- + ## How-to: Enable GameCube Boot Main Menu **Prerequisite:** Place the GameCube `IPL.bin` BIOS in the save folders (see above). 1. Open Dolphin or Primehack in `RetroDECK Configurator` by selecting `Open Emulator` -> `Dolphin` / `Primehack`. 2. Go to `Options` -> `Configuration` -> `GameCube` and uncheck `Skip Main Menu`. + + diff --git a/wiki-rtd/docs/wiki_images/emulators/dolphin/emulated-bluetooth.png b/wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/emulated-bluetooth.png similarity index 100% rename from wiki-rtd/docs/wiki_images/emulators/dolphin/emulated-bluetooth.png rename to wiki-rtd/docs/wiki_emulator_guides/dolphin-primehack/emulated-bluetooth.png