P/EMU/SDL

P/EMU/SDL emulates Aquaplus PIECE. It reads 1 file, 1 of them required: without a required file it does not start games.

About this profile

Detail	Value
Type	standalone
Classification	Community fork
Source	https://github.com/yonkuma/piemu
Upstream	https://github.com/autch/piemu
Version	git
Revision	yonkuma/piemu@0785214f1374, autch/piemu@23208626e16e
Revision held	AmberELEC, the only platform that ships it, builds this revision (AmberELEC packages/games/emulators/piemu/package.mk:5). Later commits are not part of that build.
Profiled	2026-10-22
Profile	YAML, JSON
Cores	piemu
Systems	Aquaplus PIECE

Install this emulator's files

With AmberELEC: the installer finds AmberELEC and its BIOS folder, then downloads only the files P/EMU/SDL reads there and checks each one.

On the device

Open a terminal on the device. Or connect from a computer with SSH, a terminal over the network. Paste the line. Press Enter.

Terminal

curl -fsSL https://raw.githubusercontent.com/Abdess/retrobios/main/install.sh | sh -s -- --emulator piemu

Technical notes

Autch's SDL port of Naoyuki Sawa's P/EMU, with two commits by YonKuma that add game controller input and a quit hotkey. AmberELEC builds this revision and installs piemu with the mkpfi and pfar tools built from the same tree. ref: AmberELEC packages/games/emulators/piemu/package.mk:5-6,19-29

The emulator reads one file, piece.pfi, from its working directory: a PFI header with the SYSTEMINFO block, then the flash contents at the stored offset. A missing file, a signature other than PFI1 or a SYSTEMINFO of the wrong size stops it. ref: piemu.c:5-20, piemu.c:25-45

That image holds the P/ECE kernel, its file system and the installed programs. AmberELEC's piemu.sh builds it for every launch in /tmp/piemu: mkpfi writes a fresh image from the kernel update image all.bin in the BIOS directory, then pfar adds the .pex program, its .sav file or the files a .pfs list names. A .pfi game never starts: the extension test lacks its $, so the image is not copied into the working directory. ref: AmberELEC packages/games/emulators/piemu/bin/piemu.sh:10,22-54

Files

1 file: 1 required, 0 optional.

In this collection: 1 in repo and 0 missing.

Required

all.bin required in repo

P/ECE kernel update image (PieceSystem 1.20, update/all.bin)

• System: Aquaplus PIECE

• Size: 504.0 KB
• Asked for by: this build
• Source: tools/mkpfi.c:13 (this build), tools/mkpfi.c:30-62 (this build), tools/mkpfi.c:64-128 (this build)
• Collection copy: bios/Aquaplus/PIECE/update/2mb/all.bin

• mkpfi checks the "Piece Kernel Program" signature at offset 8, writes the boot vector 0x00C02004 into sector 0, leaves sector 1 blank and copies the file from sector 2. Called without -2mb, it builds the 512 KB flash layout of factory units.

Next steps

• Get your files, for the setup you play on
• Every system, and the files each one needs
• When a game does not start

Data as of 24 October 2026.