Platform:Nintendo Wii U
| Developer | Nintendo |
|---|---|
| Endianness | big |
| On this wiki | Facts · Code · Notes · Topics |
Nintendo's eighth-generation home console (2012): a big-endian three-core PowerPC CPU (Espresso, a Broadway/Gekko descendant) with an AMD-based GPU, running Cafe OS whose executables are RPX and RPL files, an ELF variant. It keeps the Wii's PowerPC lineage but replaces DOL/REL with ELF-based modules.
Overview
The Wii U ran Cafe OS (kernel, loader and system libraries such as coreinit, gx2, nn_*, vpad, ax). Software is distributed as .rpx executables and .rpl libraries (Format:RPX and RPL) in a title's code folder. Sources read for this page: decaf-emu (GPL) and Cemu (MPL-2.0), two emulators, plus devkitPro/wut (homebrew toolchain headers). Unverified: Espresso is three PowerPC 750-derived cores at about 1.24 GHz with paired singles, in a package with the AMD Latte GPU and 2 GB of RAM (general knowledge, not read in a source for this page).
How it differs from the Wii
- Executables: the Wii and GameCube use Format:DOL executable plus Format:REL relocatable module; the Wii U uses ELF-based Format:RPX and RPL, imports resolved by the system loader and sections compressed with zlib.
- Both are big-endian PowerPC (Platform:Nintendo Wii has a single Broadway core); Wii U code runs on three cores under a multi-process OS with a separate kernel and loader. Unverified: the Wii U also contains a Wii-mode (vWii) environment for Wii software, not covered here.
- Resource formats moved from GameCube-era archives (Format:RARC archive, Format:U8 archive) to the sead-library family: Format:SARC archive, Format:BYML, Format:BFRES, Format:BRSTM, BCSTM and BFSTM streams (BFSTM), usually compressed with Format:Yaz0 (.szs). The same formats continue on the Switch (Platform:Nintendo Switch) in little-endian form.
Virtual memory map
decaf-emu's kernel keeps a table of the regions it maps; the main ones are in Fact:Nintendo Wii U/behavior/Virtual memory map: application code ends at 0x10000000 and starts at 0x02000000 by default, application data from 0x10000000, the foreground bucket at 0xE0000000, MEM1 at 0xF4000000 and shared data at 0xF8000000. These match the bases wut-tools links RPX files at.
Dynamic loading
Games and homebrew load libraries at run time with OSDynLoad_Acquire and look up symbols with OSDynLoad_FindExport. wut's coreinit/dynload.h lists the error codes (Fact:Nintendo Wii U/enum/OSDynLoad error codes) and the notify structure passed to loader callbacks (Fact:Nintendo Wii U/struct/OSDynLoad_NotifyData).
Toolchain
Homebrew builds with devkitPPC and wut (headers and import stubs for Cafe OS libraries), then elf2rpl from wut-tools turns the ELF into an RPX. The import stubs become .fimport_<lib> / .dimport_<lib> sections. Console keys and title encryption are out of scope of this wiki.
Emulators as references
- decaf-emu's loader (src/libdecaf/src/cafe/loader) mirrors the real Cafe loader, including function names such as LiLoadRPLBasics and its numeric error codes.
- Cemu (src/Cafe/OS/RPL) re-implements the loader with fewer checks and provides the system libraries as built-in modules.
Code & repositories
- https://github.com/decaf-emu/decaf-emu @
e6c528a20a41c34e0f9eb91dd3da40f119db2dee· license: GPL-3.0
decaf-emu, a Wii U emulator; src/libdecaf/src/cafe/loader holds the Cafe OS loader (RPL structs, file info, CRC and zlib handling) and src/libdecaf/src/cafe/kernel/cafe_kernel_mmu.cpp the virtual memory map
Tested on: source read, not run: source read only, not built · checked 2026-10-18; last activity 2024-09-03; Note: the latest release ships binaries; the wiki links only the source, never the binaries - https://github.com/cemu-project/Cemu @
a53cf0ece75964aa361056edab46f281dcc0bc44· license: MPL-2.0
Cemu, a Wii U emulator (MPL-2.0); src/Cafe/OS/RPL has the RPX/RPL loader (rpl.cpp, rpl_structs.h)
Tested on: source read, not run: source read only, not built · checked 2026-10-18; last activity 2026-10-15; Note: the latest release ships binaries; the wiki links only the source, never the binaries - https://github.com/devkitPro/wut @
937f0d6901f5e2a72672154a674ec47b63e2f417· license: Zlib
wut, the Wii U Toolchain: C headers of Cafe OS libraries, for example include/coreinit/dynload.h
Tested on: source read, not run: source read only, not built · checked 2026-10-18; last activity 2026-10-10