master
SDL_Init failed with 'kmsdrm not available' because SDL2's KMSDRM backend cannot resolve the vendor Mali EGL by itself. Export LD_PRELOAD=/usr/lib/libmali.so in the Setup file_manager.sh and patch it from the build script. Verified on the device: 351Files starts and runs instead of returning to ES.
G90 handheld (RK3128) — dump analysis, patched firmware, upstream port notes
Everything gathered about the generic 7" "G90" retro handheld: what the stock firmware is, how the device is wired, a patched root filesystem with SSH and WireGuard, the EmuELEC OTA format, and what upstreaming it would take.
Collected 2026-11-17/18 from a full eMMC/SD dump plus the Kagi research
conversation that started it (see conversation.md). No hardware access was
required for any of the analysis below; the device was only read through its
disk image.
TL;DR
- The G90 is not running a locked-down mystery OS. It is a custom EmuELEC 4.7 build (kernel 5.10.160, Rockchip vendor BSP) on a standard EmuELEC partition layout. It looks locked only because SSH was stripped and its autostart hook was commented out.
- The stock boot chain is plain FAT +
extlinux, unsigned, with all-zero.MD5files. Replacing the root filesystem is a file copy. out/SYSTEM.patchedadds dropbear SSH, WireGuard (userspace),jq,dtach,iperf3andtcpdump, all static ARMv7 binaries, and seeds six authorized keys on first boot.- It also restores the hidden Setup menu with the 351Files file manager,
which the vendor removed from
es_systems.cfgwhile leaving the binary in/usr/bin/351Files. - A web file manager (dufs) on port 8080, read-write over
/, with WebDAV support — see docs/patched-system.md. - The OTA drop folder lives on the FAT32 ROMs partition (
EEROMS:/.update), bind-mounted over/storage/.update— so it is writable from Android. - Upstream EmuELEC has no RK312x device, and 4.8 ships aarch64-only. A port is
possible via
rockchip-4.4(already in tree) but needs a DTS, a gamepad driver and WiFi; mainline is possible from 6.6 but needs panel/audio/battery drivers. - The G90's WiFi is a Seekwave SV6160 (RK915). Its firmware is byte-identical
to the blobs in the clean-room mainline driver
aenertia/sv6160-rk915.
Device
| SoC | Rockchip RK3128, 4x Cortex-A7, Mali-400 MP2 |
| RAM | 512 MB per the box; some batches report 1 GB |
| Display | 7" IPS, 600x1024 native (portrait), 4-lane MIPI-DSI, PWM backlight |
| Storage | 4 GB eMMC + SD card (the bootable system in these dumps is the SD) |
| WiFi | Seekwave SV6160 / Rockchip RK915, SDIO |
| Audio | RK3128 internal codec, speaker amp + headphone detect |
| Battery | rk30-adc-battery with a 28-entry table, DC jack charging |
| Input | 18 GPIO buttons + 2 ADC sticks + RGB LED; 4 ADC volume/menu keys |
Full pin/ADC/regulator detail: docs/hardware.md.
Card layout (the dump)
| # | Offset | Size | FS | Label | Role |
|---|---|---|---|---|---|
| 1 | 16 MiB | 768 MiB | FAT16 | EMUELEC |
KERNEL, SYSTEM, extlinux/, logos |
| 2 | 784 MiB | 512 MiB | swap | — | swap |
| 3 | 1296 MiB | 4848 MiB | ext4 | STORAGE |
/storage: config, saves, overlays |
| 4 | 6144 MiB | 42.8 GiB | FAT32 | EEROMS |
/storage/roms: ROMs, ports, .update |
Boot chain, matching the CFW layout exactly: idbloader @32 KiB, uboot.img
@8 MiB, trust.img @12 MiB.
Stock firmware
SYSTEM: SquashFS 4.0, lzo, 512 K blocks, 596,677,186 B, EmuELEC4.7-Nexus_devel_20260507161504,LIBREELEC_ARCH=RK312x.arm.KERNEL: ARM zImage, Linux 5.10.160, built 2026-05-07.- Device trees:
rk3128-evb-ddr3-v10-linux.dtb(+-hdmivariant) — EVB name, but contain the real G90 panel, keys, battery and gamepad configuration. Text dump:docs/dtb/g90.dts.txt. - Boot config:
docs/boot/extlinux.conf. - The build is a private EmuELEC fork (
BUG_REPORT_URL git@192.168.0.55:emuelec/emuelec).
What is in this repository
| Path | Contents |
|---|---|
docs/hardware.md |
hardware decoded from the stock DTB + boot area |
docs/patched-system.md |
the SSH/WireGuard image: contents, install, usage |
docs/emuelec-ota.md |
the OTA tar format and how the updater applies it |
docs/mainline-port.md |
mainline vs vendor-4.4 assessment |
docs/wifi-rk915.md |
SV6160/RK915 findings, driver requirements |
docs/recon-rk3128-cfw-port.md |
the rk3128-cfw (Batocera) port comparison |
docs/dtb/g90.dts.txt |
full text dump of the G90 device tree |
docs/boot/ |
extlinux.conf and DTB config files from the boot partition |
system/units/ |
systemd units and authorized_keys used by the patched image |
system/es/ |
patched es_systems.cfg (setup system) and trimmed setup gamelist |
system/bin/batocera-wifi |
rewritten WiFi helper (single parse, timeouts, enable/disable) |
system/units/dufs.service |
web file manager unit (dufs, port 8080) |
scripts/enable-setup-menu.sh |
adds the Setup entry to an already-flashed card |
scripts/build_patched_system.sh |
reproducible build of the patched rootfs |
extract_partitions.py |
extract partitions from a zstd-compressed dump |
extract_boot_parts.py |
extract the 16 MiB boot area + partition 1 |
fdt_dump.py |
DTB dumper (no dtc needed) |
export_kagi_share.py |
export a Kagi Assistant share to markdown |
conversation.md |
the research conversation that produced this repo |
Not in git (too large, regenerate locally)
out/SYSTEM.patched(573 MiB) — build withscripts/build_patched_system.shg90-p1-patched.img(768 MiB) — p1 with the patchedSYSTEMg90-boot-area-16MiB.img,g90-boot-partition-1.img,g90-p3.img,g90-p4.imgout/root-password.txt— the generated root password, deliberately kept out of the repository- the original
g90-disk.img.zstd(5.1 GiB)
Reproduce
# 1. extract the partitions from the full dump
./extract_boot_parts.py # 16 MiB boot area + first partition
./extract_partitions.py 3 4 # STORAGE and (partial) ROMs
# 2. build the patched rootfs (downloads toolchains, builds static armhf bins)
STOCK=/path/to/SYSTEM.squashfs ./scripts/build_patched_system.sh
# 3. install: copy out/SYSTEM.patched onto the FAT boot partition as SYSTEM
Upstream status (short version)
- rk3128-cfw (Batocera 4.4): needs a G90 DTS, a
micro,gamepaddriver and the rk915 driver; keeps a 2015 kernel. Seedocs/recon-rk3128-cfw-port.md. - Upstream EmuELEC: no RK312x device, releases are aarch64-only; the pieces
for a 32-bit
rockchip-4.4device are present (rk3128.dtsi,evb-rk3128_defconfig,RK3128MINIALL.ini). Seedocs/mainline-port.md. - Mainline: RK3128 support landed in 6.6 (VOP/DSI/DPHY/lima/hantro all present). Missing: panel init sequence, rk3128 audio codec, battery, and — until now — WiFi. The WiFi driver now exists as a clean-room 6.18 mac80211 driver that needs an ARMv7 port and a dw_mmc quirk patch.
Notes
docs/patched-system.mdreferencesout/root-password.txt; that file is not committed. Regenerate or set your own hash when building.- Codeberg's domain went into registrar
clientHoldon 2026-11-18, socodeberg.orgwas NXDOMAIN. Its historical address217.197.84.140still serves it; seedocs/wifi-rk915.mdfor details.
Description
G90 (RK3128) handheld: firmware dump analysis, patched EmuELEC system, upstream porting notes
321 KiB
0 Stars
1 Watchers
0 Forks
Languages
Shell
55%
Python
45%