| Both sides previous revision Previous revision Next revision | Previous revision |
| systems:wiiu [2023/01/16 09:47] – [ROMs] .wua format maioni | systems:wiiu [2024/08/16 14:34] (current) – Add support for Wiimotes batocera-user |
|---|
| * **Emulator:** [[#cemu|Cemu]] | * **Emulator:** [[#cemu|Cemu]] |
| * **Folder:** ''/userdata/roms/wiiu'' | * **Folder:** ''/userdata/roms/wiiu'' |
| * **Accepted ROM formats:** ''.wup'', ''.wud'', ''.wux'', ''.rpx'', ''.squashfs'' | * **Accepted ROM formats:** ''.wup'', ''.wud'', ''.wua'', ''.rpx'', ''.squashfs'' , ''.wux''* |
| |
| | *''.wux'' removed in v37, but back in v38+ |
| ===== BIOS ===== | ===== BIOS ===== |
| |
| * ''wud'': a single file, which is a direct physical game dump, this format requires an accurate ''keys.txt'' file. | * ''wud'': a single file, which is a direct physical game dump, this format requires an accurate ''keys.txt'' file. |
| * ''wux'': single-file compressed versions of ''.wud'' dumps, this format requires an accurate ''keys.txt'' file. | * ''wux'': single-file compressed versions of ''.wud'' dumps, this format requires an accurate ''keys.txt'' file. |
| * ''wua'': single-file compressed file, it's a life that contains both base, update and dlcs game content. (Supported since Cemu version 1.27) | * ''wua'': single-file compressed file, it's a file that contains both base, update and dlcs game content. (Supported since Cemu version 1.27) |
| * ''Loadiine'': a directory structure with multiple files and folders, usually shared as an archive. You must unpack the archive and place the containing folder in the ROMs directory. This format is a decrypted version of ''.wud'' dumps. Batocera will use the ''[game].rpx'' binary file in the ''/code/'' directory structure of the Loadiine unarchived ROM to launch the game. | * ''Loadiine'': a directory structure with multiple files and folders, usually shared as an archive. You must unpack the archive and place the containing folder in the ROMs directory. This format is a decrypted version of ''.wud'' dumps. Batocera will use the ''[game].rpx'' binary file in the ''/code/'' directory structure of the Loadiine unarchived ROM to launch the game. |
| |
| | How to [[:disk_image_compression#wua|compress files to .wua]] format. |
| ==== keys.txt ==== | ==== keys.txt ==== |
| |
| ==== Cemu ==== | ==== Cemu ==== |
| |
| [[http://cemu.info/|Cemu]] is a closed-source Wii U emulator created in October 2015 and is regularly updated every 2 to 5 weeks. It can launch or play a lot of commercial games, 10% of tested titles are perfect and 35% are, at least, playable which sums to 45% of total tested titles, with varying degrees of glitches for the imperfect ones. Check out the up-to-date official [[http://compat.cemu.info|compatibility list]] for more information. | [[http://cemu.info/|Cemu]] is a free and open-source Wii U emulator created in October 2015. Though still under development, it is able to run the majority of commercial games smoothly, 15% of tested titles are perfect and 38% are, at least, playable which sums to 45% of total tested titles, with varying degrees of glitches for the imperfect ones. Check out the up-to-date official [[http://compat.cemu.info|compatibility list]] for more information. |
| | |
| As the emulator is distributed as a precompiled binary for Windows Batocera runs Cemu through [[https://www.winehq.org/|Wine]] like [[systems:windows|Windows games]]. This has no impact on compatibility and is well tested. | |
| |
| === Cemu configuration === | === Cemu configuration === |
| Standardized features available to all cores of this emulator: ''wiiu.videomode'' | Standardized features available to all cores of this emulator: ''wiiu.videomode'' |
| |
| ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ | ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ |
| ^ Settings that apply to all cores of this emulator || | ^ Settings that apply to all cores of this emulator || |
| | **GRAPHICS BACKEND ''wiiu.gfxbackend''** | Choose your graphics rendering\\ => OpenGL ''OpenGL'', Vulkan ''Vulkan''. | | | **GRAPHICS BACKEND ''wiiu.gfxbackend''** | Choose your graphics rendering\\ => OpenGL ''OpenGL'', Vulkan ''Vulkan''. | |
| | **ASYNC SHADER ''wiiu.async''** | Speedup shader compilation (Vulkan only)\\ => Off ''0'', On ''1''. | | | **ASYNC SHADER ''wiiu.async''** | Speedup shader compilation (Vulkan only)\\ => Off ''0'', On ''1''. | |
| | **RUMBLE ''wiiu.rumble''** | To use vibration on games with Rumble mode\\ => Off ''0'', On ''1''. | | | **RUMBLE ''wiiu.rumble''** | To use vibration on games with Rumble mode\\ => Off ''0'', On ''1''. | |
| | **CONTROLLER COMBINATION ''wiiu.controller_combination''** | Use Pro Controller if the game asks for Shake\\ => GamePad + 4 Pro Controller ''0'', GamePad + 4 Sideway Wiimote ''1'', 5 Pro Controller ''2'', 5 Sideway Wiimote ''3''. | | | **CONTROLLER COMBINATION ''wiiu.controller_combination''** | Use Pro Controller if the game asks for Shake\\ => GamePad + 4 Pro Controller ''0'', GamePad + 4 Sideway Wiimote ''1'', 5 Pro Controller ''2'', 5 Sideway Wiimote ''3''. | |
| | | **AUDIO CHANNELS ''cemu_audio_channels''** | Choose the audio output type.\\ => Stereo (Default)''1'',Surround''2'' | |
| | | **AUDIO OUTPUT ''cemu_audio_config''** | Fix screen tearing.\\ => Set in Config - choose if no audio output''false'',Batocera sets first audio device (Default)''true'' | |
| | | **VSYNC ''cemu_vsync''** | Fix screen tearing.\\ => Off (Default)''0'',Double buffering''1'', Triple buffering''2'' | |
| | | **UPSCALE FILTER ''cemu_upscale''** | Choose upscaling method.\\ => Bilinear (Default)''0'', Bicubic''1'', Hermite''2'', Nearest Neighbour''3'' | |
| | | **DOWNSCALE FILTER ''cemu_downscale''** | Choose downscaling method.\\ => Bilinear (Default)''0'', Bicubic''1'', Hermite''2'', Nearest Neighbour''3'' | |
| | | **ASPECT RATIO ''cemu_aspect''** | Change the output resolution ratio.\\ => Keep Aspect Ration (Default) ''0'', Stretch ''1'' | |
| | | **ENABLE MOUSE ''cemu_touchpad''** | Enable mouse input to simulate touchscreen.\\ => Disabled (Default) ''false'', Enabled ''true'' | |
| | | **ENABLE PERFORMANCE OVERLAY ''cemu_overlay''** | Enable Cemu's performance overlay.\\ => Disabled (Default) ''false'', Enabled ''true'' | |
| | | **ENABLE NOTIFICATIONS ''cemu_notifications''** | Enable notifications of cache, controller events etc.\\ => Disabled (Default) ''false'', Enabled ''true'' | |
| | | **ENABLE GAMEPAD VIEW ''cemu_gamepad''** | Enable gamepad view for games that have interaction across two screens. Use Hotkey+R2 to switch screens.\\ => Disabled (Default) ''false'', Enabled ''true'' | |
| |
| <WRAP center round info> | <WRAP center round info> |
| Cemu emulates motion control via ''mouse gesture'' + ''right mouse button'' | Cemu emulates motion control via ''mouse gesture'' + ''right mouse button'' |
| |
| FIXME add wiimote support | ==== Wiimote support ==== |
| | Since v41, Wiimotes may be used as controllers in Cemu. To do so, pair a Wiimote and make sure the **MODE** in **WIIMOTE GUN SETTINGS** is set to **JOYSTICK** (not **GUN**). Both models Wiimote (RVL-003) and Wiimote incl. MotionPlus (RVL-036) are supported. |
| | |
| | Extensions may be used as far as Cemu supports them. |
| | Reported as working in Cemu 2.0-81: |
| | * RVL-003 with Nunchuk or MotionPlus or both |
| | Reported as not working in Cemu 2.0-81 (see [[https://github.com/batocera-linux/batocera.linux/pull/12291|PR #12291]] for details): |
| | * RVL-003 with Classic Controller (broken button mapping) |
| | * RVL-003 with Classic Controller Pro (not recognized) |
| | * RVL-036 with any extension (unstable connection) |
| |
| ===== Troubleshooting ===== | ===== Troubleshooting ===== |
| |
| ==== Migration v30 to v31 ==== | ==== Migration from v35 to v36 ==== |
| | |
| | Batocera uses the Windows build of Cemu up to v35 and the Linux build from v36. |
| | |
| | The directory layout of these builds is incompatible to each other. It was reported that Cemu in v36 does not properly start with the v35 configuration in place. Thus, the configuration must be moved before Cemu is started for the first time after migration: |
| | |
| | * ''%%mv /userdata/system/configs/cemu/ /userdata/system/configs/cemu-wine/%%'' |
| | |
| | If you'd like to keep your existing data, copy it to the new location: |
| | |
| | * Save states: ''%%cp -a /userdata/saves/cemu/drive_c/cemu/ /userdata/saves/wiiu/%%'' |
| | * Graphic packs: ''%%cp -a /userdata/system/configs/cemu-wine/graphicPacks/ /userdata/saves/wiiu/graphicPacks/%%'' |
| | * Shader cache: ''%%cp -a /userdata/system/configs/cemu-wine/shaderCache/ /userdata/system/cache/cemu/shaderCache/%%'' |
| | |
| | After verifying that everything works as expected, and if you're sure that the old data of v35 is not required anymore, you can remove the files: |
| | |
| | * ''%%rm -r /userdata/system/configs/cemu-wine/ /userdata/saves/cemu/%%'' |
| | |
| | If you'd like to go back from v36 to v35 instead, you have to undo the move: |
| | |
| | * ''%%mv /userdata/system/configs/cemu/ /userdata/system/configs/cemu-linux/%%'' |
| | * ''%%mv /userdata/system/configs/cemu-wine/ /userdata/system/configs/cemu/%%'' |
| | |
| | ==== Migration from v30 to v31 ==== |
| |
| After you make upgrade of Batocera in **v31** you need to move your backups. | After you make upgrade of Batocera in **v31** you need to move your backups. |
| * ''%%cp -a /userdata/saves/cemu/sys /userdata/saves/cemu/drive_c/cemu%%'' | * ''%%cp -a /userdata/saves/cemu/sys /userdata/saves/cemu/drive_c/cemu%%'' |
| * ''%%cp -a /userdata/saves/cemu/usr /userdata/saves/cemu/drive_c/cemu%%'' | * ''%%cp -a /userdata/saves/cemu/usr /userdata/saves/cemu/drive_c/cemu%%'' |
| | |
| |
| ==== Further troubleshooting ==== | ==== Further troubleshooting ==== |