gen1recomp/docs/anbernic-rg34xxsp.md

Anbernic RG34XXSP (Stock OS 64-bit MOD)

Download gen1recomp-*-rg34xxsp-stockos64-mod.zip from Releases. This build targets Stock OS 64-bit MOD on the RG34XXSP with PortMaster installed (TF1).

Install

1. Unzip the release on your computer. You get Gen1recomp.sh and a gen1recomp/ folder.

2. Copy both onto the SD card under Roms/PORTS/ so the layout is:

   Roms/PORTS/Gen1recomp.sh
   Roms/PORTS/gen1recomp/
   

   On the device that path is /mnt/mmc/Roms/PORTS/. Keep the launcher and the gen1recomp/ folder as siblings — do not nest the .sh inside the folder.

3. Put your legal US Red and/or Blue .gb files inside the game folder:

   Roms/PORTS/gen1recomp/lovegame/
   

   Example: Roms/PORTS/gen1recomp/lovegame/Pokemon - Red Version.gb

4. Eject the card, boot the handheld, open Ports → Gen1recomp.

5. On the launcher, move the cursor with the D-pad or left stick, press A to click. Choose the Red or Blue tab, then Choose ROM — with no file picker on stock OS, that scans lovegame/ for the .gb you dropped in.

The port ships with portable.txt already in place, so after import the saves and ROM-derived cache stay next to the game on the SD card. See Portable Mode for what that means.

Only the canonical 1 MiB US carts import:

• Red: ea9bcae617fdf159b045185467ae58b2e4a48b9a
• Blue: d7037c83e1ae5b39bde3c30787637ba1d4c48ce2

Launcher controls

Input	Action
D-pad / left stick	Move cursor
A	Click
L1 / R1	Switch tabs
Right stick	Scroll lists
Start / Select	Play or Choose ROM

In-game controls use the normal PortMaster / SDL pad map, rebindable under OPTIONS → CONTROLS.

Notes

GBC FX is off on this device. The launcher exports POKEPORT_GBCFX=0, which hides the GBC FX row from OPTIONS, pins the level to OFF, and clears a level carried over in an options.lua from another machine. The H700's Mali GPU is in the same class as the phone GPUs that compile that present pass and then show a black frame (issue #136), and love.system.getOS() reports "Linux" here, so the Android gate would not have caught it. Every other display option — COLORS, TILT, ZOOM, VOID FILL, MAX FPS — works normally. If your device turns out to handle the pass, launch with POKEPORT_GBCFX=1 to put the row back.

The pack bundles the LÖVE 11.5 aarch64 runtime from PortMaster, so the device does not need a separate love_11.5 runtime download on first launch. The launcher resolves paths relative to its own directory rather than PortMaster's $directory, because stock Anbernic firmware runs ports out of roms/PORTS/ with its own casing and mount points.

If a launch fails, Roms/PORTS/gen1recomp/log.txt holds the output of the last run.

Building the port

Release runs build this automatically (see .github/workflows/release.yml). To build it by hand:

./build-rg34xxsp.sh --version 0.1.0   # -> dist/rg34xxsp/gen1recomp-rg34xxsp-stockos64-mod.zip

install-rg34xxsp.sh copies that pack straight onto a mounted SD card for local testing.

Stock OS 64-bit MOD comes from cbepx-me.