merge wii

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
-
-<img src="../../../wiki_images/emulators/dolphin/emulated-bluetooth.png" width="450">
-
-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`.
-
-<img src="../../../wiki_images/emulators/dolphin/dolphin-bluetooth-pass.png" width="450">
-
-Change Bluetooth type:
-
-- From `Emulate the Wii's Bluetooth adapter` to `Passthrough a Bluetooth Adapter`
-
-Enable the following checkboxes:
-
-<img src="../../../wiki_images/emulators/dolphin/dolphin-connect-scan.png" width="450">
-
-- `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.

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
+
+<img src="../../../wiki_images/devices/wii-bar.png" width="150"> <img src="../bluetooth-dongle.png" width="80">
+
+- 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
+
+<img src="../emulated-bluetooth.png" width="450">
+
+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`.
+
+<img src="../dolphin-bluetooth-pass.png" width="450">
+
+Change Bluetooth type:
+
+- From `Emulate the Wii's Bluetooth adapter` to `Passthrough a Bluetooth Adapter`
+
+Enable the following checkboxes:
+
+<img src="../dolphin-connect-scan.png" width="450">
+
+- `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`.
+
+