Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Platform:Nintendo Wii U

From ReverseEngineering.wiki
Platform
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

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