Differences

This shows you the differences between two versions of the page.

--- systems:wii [2022/08/23 06:24] – [Using Bluetooth passthrough] nadenislamarre
+++ systems:wii [2024/08/06 06:18] (current) – [Native Wiimote using native Bluetooth] make it more obvious that we are not emulating the controls and are using them natively atari
@@ Line 21: / Line 21: @@
 ==== Quick reference ====
-  * **Emulator:** [[#dolphin|Dolphin]]
   * **Accepted ROM formats:** ''.gcm'', ''.iso'', ''.gcz'', ''.ciso'', ''.wbfs'', ''.wad'', ''.rvz'', ''.elf'', ''.dol'', ''.m3u'', ''.json''
   * **Folder:** ''/userdata/roms/wii''
+^ Emulators ^
+| [[#dolphin|Dolphin]] |
+| [[#libretro:_dolphin|libretro: Dolphin]] |
 ===== BIOS =====
-No Nintendo Wii emulator in Batocera needs a BIOS file to run.
+The libretro version of Dolphin requires its NAND to be stored in ''bios/dolphin-emu/Sys''.
+The standalone version will generate the needed files on first launch.
 ===== ROMs =====
@@ Line 73: / Line 78: @@
 ^ Settings specific to ''wii'' |
 | **EMULATE WIIMOTE ''wii.emulatedwiimotes''** | Use your gamepad like a vertical Wiimote in game\\ => Off ''0'', On ''1''. |
-| **CUSTOMIZE WIIMOTE & GAMEPAD ''wii.controller_mode''** | Emulate a Wiimote Sideway with L2 for Shake and Nunchuk on R-stick\\ => Off ''disabled'', Classic Controller ''cc'', Wiimote Sideway ''side'', Wiimote Sideway + Swing ''is'', Wiimote Sideway + Tilt ''it'', Wiimote Sideway + Nunchuk ''in''. |
+| **CUSTOMIZE WIIMOTE & GAMEPAD ''wii.controller_mode''** | Emulate a Wiimote Sideway with L2 for Shake and Nunchuk on R-stick.\\ => Off ''disabled'', Classic Controller ''cc'', Wiimote Sideway ''side'', Wiimote Sideway + Swing ''is'', Wiimote Sideway + Tilt ''it'', Wiimote Sideway + Nunchuk ''in''. [[systems:wii:wiimoteprofiles|More details on its own page.]] |
+| **SHOW LIGHT GUN CROSSHAIRS ''wii.dolphin-lightgun-hide-crosshair''** | Show a crosshair for the Wiimote's emulated IR sensor.\\ => Off ''0'', On ''1''. |
 ==== RetroArch ====
@@ Line 79: / Line 85: @@
 RetroArch has [[emulators:retroarch|its own page]].
-=== libretro: dolphin ===
+=== libretro: Dolphin ===
-There's nothing here to configure. Use RetroArch's Quick Menu for now.
+Standardized features for this core: ''wii.autosave''
+^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^
+^ Settings that apply to all systems this core supports ||
+| **RENDERING RESOLUTION ''global.wii_resolution''** | Enhancement. Increase the rendering resolution. Makes 3D objects clearer.\\ => 1x native (640x528) ''x1 (640 x 528)'', 2x 720p (1280x1056) ''x2 (1280 x 1056)'', 3x 1080p (1920x1584) ''x3 (1920 x 1584)'', 4x 1440p (2560x2112) ''x4 (2560 x 2112)'', 5x (3200x2640) ''x5 (3200 x 2640)'', 6x 4K (3840x3168) ''x6 (3840 x 3168)''. |
+| **LANGUAGE ''global.wii_language''** | Wii NAND's language setting.\\ => English ''English'', French ''French'', German ''German'', Spanish ''Spanish'', Italian ''Italian'', Dutch ''Dutch'', Japanese ''Japanese'', Simplified Chinese ''Simplified Chinese'', Traditional Chinese ''Traditional Chinese'', Korean ''Korean''. |
+| **WIDESCREEN HACK (GLITCHY) ''global.wii_widescreen_hack''** | Enhancement. Only works with a 16/9 ratio and bezels disabled.\\ => Off ''disabled'', On ''enabled''. |
+| **UBERSHADERS ''global.wii_shader_mode''** | May not work well on all hardware. Hybrid is preferred, where supported.\\ => No Ubershaders ''sync'', Exclusive Ubershaders ''sync UberShaders'', Hybrid Ubershaders ''a-sync UberShaders'', Skip Drawing ''a-sync Skip Rendering''. |
+| **ANISOTROPIC FILTERING ''global.wii_anisotropic''** | Improves clarity of distant textures.\\ => Off ''1x'', 2x ''2x'', 4x ''4x'', 8x ''8x'', 16x ''16x''. |
+^ Settings specific to wii ||
+| **WII TV MODE ''wii.wii_widescreen''** | Wii NAND's aspect ratio setting. Most games support both ratios natively.\\ => 16:9 ''enabled'', 4:3 ''disabled''. |
+| **CONTROLLER 1 TYPE ''wii.controller1_wii''** | Emulate a Wiimote Sideway with L2 for Shake and Nunchuk on R-stick.\\ => WiiMote ''1'', WiiMote Sideways ''513'', WiiMote + Nunchuk ''769'', WiiMote + Classic Controller ''1025'', WiiMote + Classic Controller Pro ''1281'', Real Wiimote ''1536'', GameCube Controller ''1281''. |
+| **CONTROLLER 2 TYPE ''wii.controller2_wii''** | Emulate a Wiimote Sideway with L2 for Shake and Nunchuk on R-stick.\\ => WiiMote ''1'', WiiMote Sideways ''513'', WiiMote + Nunchuk ''769'', WiiMote + Classic Controller ''1025'', WiiMote + Classic Controller Pro ''1281'', Real Wiimote ''1536'', GameCube Controller ''1281''. |
+| **CONTROLLER 3 TYPE ''wii.controller3_wii''** | Emulate a Wiimote Sideway with L2 for Shake and Nunchuk on R-stick.\\ => WiiMote ''1'', WiiMote Sideways ''513'', WiiMote + Nunchuk ''769'', WiiMote + Classic Controller ''1025'', WiiMote + Classic Controller Pro ''1281'', Real Wiimote ''1536'', GameCube Controller ''1281''. |
+| **CONTROLLER 4 TYPE ''wii.controller4_wii''** | Emulate a Wiimote Sideway with L2 for Shake and Nunchuk on R-stick.\\ => WiiMote ''1'', WiiMote Sideways ''513'', WiiMote + Nunchuk ''769'', WiiMote + Classic Controller ''1025'', WiiMote + Classic Controller Pro ''1281'', Real Wiimote ''1536'', GameCube Controller ''1281''. |
+Further options can be adjusted in RetroArch's Quick Menu ( ''[HOTKEY]'' + {{:wiki:south.png?nolink&20|South button (B SNES)}} in-game).
 ===== Controllers for the Wii =====
 {{emulators:wii-candles.jpg?512|For emergency use only.}}
-You have two choices to use controllers for playing Wii on Batocera.
+There are multiple choices for controllers and connections for playing Wii on Batocera:
+  * [[#native_wiimote_using_native_bluetooth|Native Wiimote using native Bluetooth]]: Use original Wiimote controllers with either a native Bluetooth receiver.
+  * [[#native_wiimote_using_a_dolphinbar|Native Wiimote using a Dolphinbar]]: Use original Wiimote controllers with a Dolphinbar.
+  * [[#emulated_wiimote_classic_controller_with_a_gamepad|Emulated Wiimote/Classic controller with a gamepad]]: Use a standard gamepad to emulate a Wiimote for the emulated game.
+  * [[#emulated_gamecube_controller_with_a_gamepad|Emulated GameCube controller with a gamepad]]: Use standard gamepads for [[#classic_controller_compatible_games_list|classic/GameCube controller-compatible games]]. This is the default mode.
-  * **Wiimote**: Use original Wiimote controllers with a bluetooth controller (the **DolphinBar** usage is discouraged)
+==== Native Wiimote using native Bluetooth ====
-  * **Gamepad**: Use standard gamepads with analog stick for games that can originally be played with Wii Classic Controller and GC Controller.
-<WRAP center round important>
+{{:emulators:wiibar.jpg?250|USB-powered IR LED bar.}}
-Due to problems of the IR LEDs burning out from staying on too long, the v5 firmware released in late 2015 turns off the DolphinBar's IR LED lights when they are not needed, such as when no Wiimotes are connected or when the **DolphinBar** is in a mode where the pointer cannot be used. But unlike the old problematic sensor bars that turned off after a set time, the DolphinBar knows when the wiimote is being used, so it presents no problems. To anyone who hasn't updated their DolphinBars to a version with this feature, we definitely recommend that they do so. [[https://www.mayflash.com/Support/download.php?class2=34|W010 Firmware]].
-</WRAP>
-==== Configuring a real Wiimote with a DolphinBar ====
+We can use the Wiimote as if though it were connected to an original Wii, just instead of the Wii it's the emulated Wii running inside of Batocera. To do this, the Wiimote must **not** be paired to Batocera while in the EmulationStation menu, only after launching a Wii game using the Dolphin emulator. When Dolphin is launched, put the Wiimote into pair mode and it will pair. That's it. Use the IR bar as you would a normal Wii, place it either at the top or bottom of the TV screen and point at it for the on-screen Wiimote cursor.
-{{ emulators:mayflash_bar.jpg |}}
+This will work for as long as the Bluetooth dongle itself supports communicating with the Wiimote.
-It's really easy:
+An ordinary controller (or keyboard) will be required to navigate menus when outside of the emulated Wii game, as the Wiimote itself cannot be used for this.
-  * Connect your **DolphinBar** with USB to your computer
+<WRAP center round important>
-  * Press the right button to choose **MODE 4**, the Wii specific mode
+This method cannot be used simultaneously with pairing the Wiimote in EmulationStation (the main menu), as that will use the ordinary method of attempting to map the current controller to an emulated GameCube controller (by default)/Wiimote instead of the native interface.
-  * Press the left button to launch pairing
-  * Press the buttons **1 and 2** on your **Wiimote**
-  * The bar led stop to flash and on the **Wiimote** led 1 is now fixed
-Repeat for each **Wiimote** the same things and you are ready to play, nothing more to do.
+(FIXME unless you choose the "gamepad" option for the wiimote gun settings? Needs confirmation)
-=== Using Wii controllers as regular controllers for other systems with Mode 3 ===
+It is possible to sync the Wiimote to ES and then to re-sync again after opening Dolphin by using the temporary sync mode (hold ''[1]'' and ''[2]'' on the Wiimote) so it only remembers for that session if you intend on using the Wiimote to play systems other than Wii as well.
+</WRAP>
-If you use the DolphinBar in **MODE 3**, it allows you to use a Wiimote, Wiimote + Nunchuk, or a Wii Classic Controller as a normal **GameCube** gamepad that you can configure in Batocera like any other pad. Mode 3 will work with all other emulators and can save you if you don't have any other controller.
+==== Native Wiimote using a Dolphinbar ====
-But, the Wiimote, Wiimote + Nunchuk, and Classic Controller have all different button assignments, even for things that seem obvious like the D-pad. If you plug or unplug a different device, you'll have to make adjustments to your controller configuration stored in Batocera because they have all the same name **HJZ Mayflash Wiimote PC Adapter**.
-==== Using Bluetooth passthrough ====
+{{emulators:mayflash_bar.jpg|}}
-This is the default configuration. No action needed.
+The Dolphinbar acts as an intermediary body between the machine and the Wiimote. It also includes IR LEDs which automatically shut off when not in use. Its Bluetooth module is the most unresponsive of all the available options, usage of native Bluetooth connection instead is usually more responsive.
-==== Configuring another controller to simulate a Wiimote/Wii Classic Controller/GameCube controller ====
+An ordinary controller (or keyboard) will be required to navigate menus when outside of the emulated Wii game, as the Wiimote itself cannot be used for this.
-If you don't have any **Wiimote** controllers and want to use a regular controller, it's possible, but you will be limited to games already made for Wii Classic Controller and GC Controller.
+  - Connect your **DolphinBar** with USB to the machine.
+  - Press the right (FIXME MODE?) button to switch to **MODE 4**, the passthrough mode.
+  - Launch any Wii game from ES using a traditional controller.
+    * **To permanently pair the Wiimote:**
+    - On the Wiimote, hold down the red sync button inside of the battery compartment. The LEDs will begin flashing.
+    * **To only temporarily pair the Wiimote:**
+    - On the Wiimote, hold down buttons ''[1]'' + ''[2]''. The LEDs will begin flashing.
+  - Wait until the LEDs stop flashing. Once they do, the Wiimote is connected to the emulated Wii system.
-You can turn this option on by going to advanced system settings for the Nintendo Wii > Emulate Wiimote to "On". You can also manually edit your ''batocera.conf'' file in ''/userdata/system/'' (or ''system'' in the SHARE NFS network drive) and turn on ''wii.emulatedwiimotes=1'' like so:
+Repeat for each **Wiimote** desired.
-<code xml>
+For more info, refer to the [[hardware:dolphinbar|Dolphinbar-specific page]].
-  ## wiimotes
-  ## real wiimotes must not be paired with batocera.linux system so that they can work with the wii emulator
-  ## set emulatedwiimotes to 1 to emulate wiimotes with standard pads
-  wii.emulatedwiimotes=1
-</code>
-Removing the ''#'' at the line start will 'uncomment' the line.
+<WRAP center round todo>
+Do the same limitations about pairing in ES apply here?
-Now your controllers will be recognized like **Wiimotes** to play games, but if you try one like **New Super Mario Bros** you will be stuck when it will ask you to shake your pad to fly with your hat. See further down for more information.
+What does the light gun page for Dolphinbar have to do with this? Maybe the link to it should be removed.
-Below is the default key mapping for Dolphin/Wii games. This is as if you are using a Wiimote in **vertical orientation**.
+There's a SYNC button on the Dolphinbar itself. What does that do in this context? Is it required to be pressed or does Batocera automatically put the Dolphinbar into pairing mode once Dolphin is launched? Is the button just a passthrough for the Dolphin hotkey which automatically puts the emulated Wii into its sync mode?
+</WRAP>
-^ Key ^ Wii Function ^ Key ^ Wii Function ^ Key ^ Wii Function ^ Key ^ Wii Function ^
+==== Using Bluetooth passthrough ====
-|x| Buttons/2|y|Buttons/1 |a| Buttons/B|b|Buttons/A |
-|l1/pageup| Buttons/-|l2/pagedown|Buttons/+ |select|Buttons/Home |start| |
-|joystick1up| IR/Up|joystick1left|IR/Left |joystick1down| IR/Down|joystick1right|IR/Right |
-|joystick2up| Tilt/Forward|joystick2left|Tilt/Left |joystick2down| Tilt/Down|joystick2right|Tilt/Right |
-But playing with your gamepad in vertical orientation is really crappy...
+<WRAP center round important>
+<wrap em>This is not required to use Wiimotes regularly with Bluetooth adapters.</wrap> Dolphin works fine using its [[#configuring_a_wiimote_using_native_bluetooth|emulated Bluetooth connections]] in most cases.
-Pre-built modifications have been baked into the configuration utility in order to support various games and remote orientation. In order to use these modifications you need to **rename** the ROM file to include one of the following extensions in the filename, as described below. You need to change the ROM filename, like for example ''New Super Mario Bros.side.iso''.
+Doing this will render your Bluetooth module inoperable with anything that //isn't// Dolphin, including navigating the EmulationStation front-end! Be sure to have a different way of navigating the menus prepared.</WRAP>
-  * **.side.** - Enables the controller to operate as a **sideways wiimote**. The following changes to the default configuration are enabled:
+<WRAP center round info>
+A keyboard and mouse are required to initially configure this.
+</WRAP>
+If instead you'd like to utilize [[https://wiki.dolphin-emu.org/index.php?title=Bluetooth_Passthrough|Dolphin's Bluetooth passthrough feature]], do the following:
+  - Go to the ''dolphin-emu-config'' application in **Files** (''[F1]'' in system list) -> **Applications**.
+  - Go to **Options** -> **Configuration** -> **Wii** and add your Bluetooth module to the **Whitelisted USB Passthrough Devices** box.<WRAP center round tip>
+You can test for this by plugging in your Bluetooth USB dongle and seeing which device appears, if that's what you're using.
+</WRAP>
+  - Close the configuration window, then launch a Wii game directly from Dolphin (double-click one of the Wii games on the list).
+  - Press ''[Alt]'' + ''[Tab]'' to go back to the Dolphin menu.
+  - Go to **Options** -> **Controller Settings** and under **Passthrough a Bluetooth adapter** click **Sync**.
+  - Press the red ''[SYNC]'' button on the underside of your Wiimote. You can either remove the battery cover to get to it or use a toothpick to press it through the hole in the cover.<WRAP center round tip>
+You can press ''[Alt]'' + ''[Tab]'' again to get in-game and confirm that your controller is working.
+</WRAP>
+  - Go to **Emulation** -> **Stop** to stop the game.
+  - Exit Dolphin.
+You can now use Bluetooth passthrough with Dolphin after launching the game from Batocera!
+<WRAP center round tip>
+Wiimote profiles can be [[systems:wii:wiimoteprofiles|manually set via Batocera configs]], however it is recommended to just [[:remapping_controls_per_emulator#wii|use Dolphin's sophisticated remapping tools]] and use a custom pad profile instead.
+</WRAP>
-^ Key ^ Wii Function ^ Key ^ Wii Function ^ Key ^ Wii Function ^ Key ^ Wii Function ^
+==== Use of the Skylanders portal with Dolphin's passthrough ====
-|x| Buttons/B|y|Buttons/A |a| Buttons/1|b|Buttons/2 |
-  * **.cc.** - Enables the controller to operate as a **classic controller**. The game must support the classic controller. The following changes to the default configuration are enabled:
+Navigate to ''[F1]'' **File manager** -> **Applications** -> **dolphin-emuconfig**
-^ Key ^ Wii Function ^ Key ^ Wii Function ^ Key ^ Wii Function ^ Key ^ Wii Function ^
+Once Dolphin is opened, navigate to **Options** -> **Configuration** -> **Wii** and then add the portal to the **Whitelisted USB Passthrough Devices**.
-|x| Buttons/X|y|Buttons/Y |a| Buttons/A|b|Buttons/B |
-|select| Buttons/-|start|Buttons/+ |l1/pageup| Triggers/L|r1/pagedown|Triggers/R |
-|l2| Buttons/ZL|r2|Buttons/ZR |||||
-|up| Classic/D-Pad/Up|down|Classic/D-Pad/Down|left|Classic/D-Pad/Left|right|Classic/D-Pad/Right|
-|joystick1up|Classic/Left Stick/Up|joystick1down|Classic/Left Stick/Left|joystick2up|Classic/Right Stick/Up|joystick2left|Classic/Right Stick/Left|
-  * **.XX.** - Enables the controller to operate with the left joystick representing the function represented by first character and the right joystick functioning as represented by the second.  The options are as follows:
+=== Batocera v35 and below ===
-^ Code ^ Function ^ Description ^
+Batocera v35 and below requires a new udev rule to be intsalled to function correctly. Save this file to ''/userdata/rules.d/51-gcadapter.rules'':
-|i| infrared|Infrared Options.  In this option, the selected joystick will act as if you were moving the infrared around|
-|s| swing|In this option, the selected joystick will act as if you were swinging it in the direction you're pushing the joystick|
-|t| tilt|In this option, the selected joystick will act as if you were tilting it in the direction you're pushing the joystick|
-|n| nunchuk|In this option, the selected joystick will act as the joystick on the nunchuk and l2 = C and r2 = Z|
-  * **Custom** - Additional configuration available on a per-game basis, mapping any of the possible keys to the keymappings in Dolphin. The file name needs to be named the same as the ROM with .cfg added to the end.  For example, to modify ''New Super Mario Bros.iso'', a configuration file could look as follows:
-<code xml| New Super Mario Bros.iso.cfg>
+<file 51-gcadapter.rules>
-'r2':'Shake/Z'
+SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", ATTRS{idVendor}=="1430", ATTRS{idProduct}=="0150", MODE="0666"
-'pageup':'Tilt/Left'
+</file>
-'pagedown':'Tilt/Right'
-'select':'Buttons/-'
-'start':'Buttons/+'
-</code>
-**NEW:** From the **5.26+ (beta 14/04/2020)** you can now **SHAKE** in game with **L2** Key, for example to play New Super Mario World while using **.side.** Wiimote orientation.
-==== Classic Controller compatible games list ====
+==== Emulated GameCube controller with a gamepad ====
-The following Wii games are compatible with the Classic Controller, and you can play them with this patch.
+This is the default mode, when nothing else is configured. Shown on a [[:configure_a_controller|Batocera RetroPad]]:
-<code>
+{{https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/gamecube.png}}
-Blast Works: Build Trade Destroy
-Bleach: Versus Crusade
-Call of Duty: Black Ops
-Call of Duty: Modern Warfare 3
-Castlevania Judgment
-Dokapon Kingdom
-Dragon Ball Z: Budokai Tenkaichi 2
-Dragon Ball Z: Budokai Tenkaichi 3
-Fifa 09
-Fifa 10
-Fifa 15
-Final Fantasy Crystal Chronicles: Echoes of Time
-Fire Emblem: Radiant Dawn
-Geometry Wars Galaxies
-G.I. Joe: The Rise of Cobra
-Grim Adventures of Billy & Mandy, The
-Guilty Gear XX Accent Core
-Harvest Moon: Tree of Tranquility
-Kirby's Dream Collection
-Mario Kart Wii
-MLB Power Pros
-MLB Power Pros 2008
-Mortal Kombat: Armageddon
-Monster Hunter Tri
-Muramasa: The Demon Blade
-MySims Racing
-Naruto: Clash of Ninja Revolution 1
-Naruto Shippuden: Clash of Ninja Revolution 3
-Naruto Shippuuden Gekitou! Ninja Taisen EX
-Naruto Shippuuden Gekitou! Ninja Taisen EX2
-Naruto Shippuuden Gekitou! Ninja Taisen EX3
-Need for Speed: Undercover
-Newer Super Mario Bros Wii [HACK]
-NHL 2k10
-NiGHTS: Journey of Dreams
-No More Heroes 2
-Opoona
-Pro Evolution Soccer 2009
-Rampage: Total Destruction
-Resident Evil Archives: Resident Evil
-Resident Evil 4 Wii Edition
-Rune Factory Frontier
-Samurai Shodown Anthology
-Sengoku Basara: Samurai Heroes
-SNK Arcade Classics Vol. 1
-Sonic Colors
-Sonic Unleashed
-SpongeBob's Truth or Square
-Super Mario Kart Wii
-Super Smash Bros. Brawl
-Taiko No Tatsujin
-Tatsunoko vs. Capcom: Cross Generation of Heroes
-Teenage Mutant Ninja Turtles: Smash-Up
-Tetris Party Deluxe
-The Last Story
-TNA Impact
-Ultimate Shooting Collection
-WWE SmackDown vs. Raw 2010
-Victorious Boxers Revolution
-Virtual Console Games
-Pro Evolution Soccer 2010 ???????
-Xenoblade Chronicles
-Zhu Zhu Pets: Featuring the Wild Bunch
-</code>
 ===== Troubleshooting =====