RG40XXV – cuaderno de campo

Puesto al día el 2 de noviembre de 2025.

instalación de mustardos

Designed to give your device a fresh, modern feel, MustardOS puts control and personalisation in your hands. With an emphasis on flexibility, it lets you shape the look, style, and behaviour of your handheld so it feels truly your own. From everyday play to inquisitive tinkering, MustardOS is built to adapt to you.
«Welcome» en MustardOS.

la instalación de MustardOS en la RG40XXV consiste en descargar el archivo correspondiente de la página de descarga de su propia web y grabar dicha imagen (en este caso, MustardOS_RG40XX-V_2508.0_GOOSE-f9f63c91.img.gz de 3,68 GB) en la tarjeta microSD de rigor vía Raspberry Pi Imager (por ejemplo).

en MustardOS, ofrecen una guía de instalación debidamente ilustrada:

Installation / Install Guide

grabación de la imagen

Raspberry Pi Imager es la aplicación recomendada en la guía de instalación de MustardOS:

Operating System > Choose OS > Use custom > MustardOS_RG40XX-V_2508.0_GOOSE-f9f63c91.img.gz

una vez concluida la operación de write, MustardOS ya está instalado en la tarjeta microSD.

configuración

al arrancar el sistema operativo por primera vez, no pasé de un pantallazo negro: en mi caso, después de resetear la consola, se inició el proceso de instalación de MustardOS con normalidad.

TIMEZONE > Europe/Madrid
DATE AND TIME > 2025/09/06 13:48
Installing MUOS...
Thank you for chosing muOS.
Your device will now reboot.

idioma

Config > Language > Spanish

wifi

la RG40XXV sólo es compatible con las redes 2.4GHz:

Configuración > Conectividad > Red Wi-Fi >
Identificador > nombre-de-la-red-wifi
Contraseña > ****** > Tratando de conectar > 192.168.1.20

en lugar de introducir el nombre del identificador de forma manual, existe la posibilidad de escanear las redes disponibles con el botón X.

ssh

Configuración > Conectividad > Servicios web > Shell seguro > Habilitado

tanto el usuario como la contraseña son «root».

en caso de duda, la dirección IP de la RG40XXV se puede consultar aquí:

Información > Detalles de la red > Dirección IP > 192.168.1.20

acceso sin contraseña

chown root:root /root
chmod 755 /root
mkdir -p /root/.ssh
chmod 700 /root/.ssh
touch /root/.ssh/authorized_keys
chmod 600 /root/.ssh/authorized_keys
ssh-keygen -b 2048 -t rsa -f ~/.ssh/RG
Generating public/private rsa key pair.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/RG
Your public key has been saved in /root/.ssh/RG.pub

cabe recordar que, dentro de authorized_keys, deben copiarse las claves públicas de los clientes interesados en acceder sin clave a la RG40XXV.

hay más información al respecto en ssh: configuración servidor-cliente.

carpeta bin en home

mkdir -p /root/bin
nano /root/.profile
## HOME/bin ##
if [ -d "$HOME/bin" ] ;
then
export PATH="$HOME/bin:$PATH"
chmod 700 $HOME
chmod 700 $HOME/.ssh/*
fi
bash
«bin: archivos ejecutables en home» en cuaderno.poderna.com.

además de export, se ejecuta el comando chmod en este punto para reponer los permisos que requiere el servicio ssh.

rutas de interés

home: /root/
TF1/INT. ó SD1: /mnt/mmc/
- ROMs: /mnt/mmc/ROMS/
TF2/EXT. ó SD2: /mnt/sdcard/
- ROMs, en caso de que se migren a la SD2: /mnt/sdcard/ROMS/
ports
- directorio del juego: /mnt/sdcard/ports/
- lanzador del juego (*.sh): /mnt/sdcard/ROMS/Ports/

luces rgb

hay dos vías, que conozca, de configurar las luces RGB de la consola:

Aplicaciones > RGB Controller > Mode > Off

Configuración > Configuración general > Luces RGB del dispositivo > Deshabilitado

temas

Configuración > Personalización > Selector de Tema > Descarga del tema > Art Book Next v1 (por ejemplo) > [Botón A] Descargar

retroachievements

Aplicaciones > RetroArch > Settings > Achievements > ON
Username > ernesto
Password > ******
Main Menu > Configuration File > Save Current Configuration

más información al respecto en recalbox en raspberry pi 3.

roms

When it comes to ROM files, muOS is unique because it doesn’t really care where you put them. You can throw them on the first card, or the second card. The only requirement is that you make a folder named “ROMS” in the root directory of whatever card you are using. From there, make subfolders however you’d like and put your games inside.
Retro Game Corps, «muOS» en Anbernic RG35XX Family Starter Guide, 2024.

es más, en Retro Game Corps, recomiendan también el uso de una segunda tarjeta SD para facilitar futuras actualizaciones de MustardOS:

For the best results, I recommend using a two-card setup with muOS, because updating this OS requires you to reflash the SD1 card.
Retro Game Corps, «muOS» en Anbernic RG35XX Family Starter Guide, 2024.

luego, en la segunda tarjeta SD, basta con crear una carpeta ROMS en su raíz para colocar dentro los distintos sistemas:

mkdir -p /media/ernesto/ROMS/ROMS
ls /media/ernesto/ROMS/ROMS
amiga600 dos gba mame megadrive nes pcenginecd scummvm snes zxspectrum
amstradcpc fbneo gbc mastersystem neogeo pcengine psx segacd varia

formato exfat

según compruebo, MustardOS no reconoce las particiones ext4 de linux. en su lugar, utiliza exfat:

gparted > Particiones de la tarjeta SD con muOS

ubuntu 20.04, desde donde escribo, no soporta el formato exfat de forma nativa:

sudo apt show exfat-utils
Description: utilities to create, check, label and dump exFAT filesystem
Utilities to manage extended file allocation table filesystem.
This package provides tools to create, check and label the filesystem.
sudo apt install exfat-utils
Se instalarán los siguientes paquetes NUEVOS:
exfat-fuse exfat-utils
gnome-disks

la aplicación Discos de gnome (gnome-disk-utility 3.36.3), a diferencia de gparted en su versión 1.0, permite crear y gestionar particiones en exfat:

Crear partición >
Nombre del volumen: ROMS
Tipo > Otro > exFAT > Crear
Montar

migrar a SD2

Configuración > Almacenamiento > [Botón X] Migrar a SD2
BIOS del sistema > SD2
Configuraciones de RetroArch > SD2
Guardar partidas + Guardar estados > SD2
Perfiles de red > SD2

portmaster

PortMaster is a simple GUI tool designed to facilitate the downloading and installation of game ports for linux handheld devices.
«What is PortMaster?» en PortMaster.

Aplicaciones > PortMaster > Todos los ports > Maldita Castilla (por ejemplo) > [Botón A] Mostrar información > [Botón A] Instalar

mientras que algunos juegos se ofrecen listos para jugar, otros incluyen instrucciones del tipo «buy the game on Steam [...] Copy all game files into the assets folder». en ambos casos, los juegos adaptados ó ports se almacenan en el directorio Ports:

Contenido > Ports > Maldita Castilla

depotdownloader

según se lee en las instrucciones del puerto de Maldita Castilla EX, hay que emplear el comando download_depot para descargar desde Steam una versión del juego compatible:

Buy the game on Steam. Open the Steam console and use the following command to download the compatible version of the game: download_depot 534290 534291 8142126060031850682. Copy all game files into the assets folder.
Ganimoth, «Cursed Castilla (Maldita Castilla EX)» en PortMaster.

pero, en octubre de 2025, no he dado con dicho programa.

en su lugar, he instalado y ejecutado depotdownloader:

wget https://github.com/SteamRE/DepotDownloader/releases/download/DepotDownloader_3.4.0/DepotDownloader-linux-x64.zip
[...]
2025-11-02 16:25:47 (2,15 MB/s) - “DepotDownloader-linux-x64.zip” guardado [33442357/33442357]
unzip DepotDownloader-linux-x64.zip
Archive: DepotDownloader-linux-x64.zip
[...]
mv DepotDownloader ~/bin/depotdownloader
depotdownloader -app 534290 -depot 534291 -manifest 8142126060031850682 -username ernesto -password ******
Connecting to Steam3… Done!
Logging 'ernesto' into Steam3…
STEAM GUARD! Please enter the auth code sent to the email at poderna.com: 4VMD9
Done!
Using Steam3 suggested CellID: 186
Got 97 licenses for account!
Got AppInfo for 534290
Using app branch: 'public'.
Got depot key for 534291 result: OK
Processing depot 534291
Downloading depot 534291 manifest
Got manifest request code for depot 534291 from app 534290, manifest 8142126060031850682, result: 14408736351593034663
Encountered error downloading depot manifest 534291 8142126060031850682: ServiceUnavailable
Encountered error downloading depot manifest 534291 8142126060031850682: ServiceUnavailable
Manifest 8142126060031850682 (10/14/2016 17:00:13)
Downloading depot 534291
Pre-allocating depots/534291/12459831/Cursed_Castilla.exe
Pre-allocating depots/534291/12459831/options.ini
Pre-allocating depots/534291/12459831/data.win
Pre-allocating depots/534291/12459831/steam_api.dll
00.00% depots/534291/12459831/options.ini
00.20% depots/534291/12459831/steam_api.dll
04.98% depots/534291/12459831/Cursed_Castilla.exe
100.00% depots/534291/12459831/data.win
Depot 534291 - Downloaded 97690752 bytes (108153408 bytes uncompressed)
Total downloaded: 97690752 bytes (108153408 bytes uncompressed) from 1 depots
Disconnected from Steam

una vez descargados los archivos de la versión compatible del juego, deben copiarse a la carpeta assets del puerto en cuestión:

rsync -avzP depots/534291/12459831/ root@192.168.1.20:/mnt/sdcard/ports/cursedcastilla/assets/

artie

Artie is a powerful art scraper designed for Anbernic devices running MuOS. It helps you download and manage artwork for your ROMs, enhancing your gaming experience with beautiful visuals and a highly optimized, responsive interface.
milouk, «Artie» en GitHub, 2025.

este gestor de media se ejecuta en la propia RG40XXV:

wget https://github.com/milouk/artie/releases/download/2.0.0/Artie.zip
[...]
2025-10-12 12:16:28 (1,14 MB/s) - “Artie.zip” guardado [37586892/37586892]
unzip Artie.zip
Archive: Artie.zip
creating: Artie/
[...]
rsync -avzP Artie root@192.168.1.20:/mnt/mmc/MUOS/application/
ssh root@192.168.1.20
nano /mnt/mmc/MUOS/application/Artie/.artie/config.json
"roms": "/mnt/sdcard/ROMS",
[...]
"screenscraper": {
"username": "nombre_de_usuario",
"password": "contraseña_del_usuario",

Artie se ejecuta desde las aplicaciones de la RG40XXV:

Aplicaciones > Artie

una vez dentro de la aplicación, se muestran las carpetas que hay en "roms" (en este caso, /mnt/sdcard/ROMS). el botón A vale para descargar el arte del título seleccionado y el botón Start, para descargar el arte de todos los títulos del directorio.

problemario

artie

en este archivo, se registran los cambios:

tail -f /mnt/mmc/MUOS/application/.artie/log.txt

el arte no aparece

mediante este comando, se puede comprobar si la descarga de los archivos se ha realizado:

ls -R /mnt/mmc/MUOS/info/catalogue/
/mnt/mmc/MUOS/info/catalogue/Nintendo NES - Famicom/box:
Astyanax (USA).png
Blue Shadow (Europe).png
Castlevania (USA).png
Castlevania II - Simon's Quest (USA).png
Castlevania III - Dracula's Curse (USA).png
Contra (World) (Contra Anniversary Collection).png
[...]

por ejemplo.

si el arte de los juegos se ha descargado y sigue sin aparecer, cabe asignarle un núcleo a los títulos del directorio en cuestión:

Explorar contenido > mastersystem > Shinobi (USA, Europe, Brazil) (En) (Rev 1) > Select > Núcleo > Sega Master System > SMS Plus GX > [Botón X] Directorio

el arte de NES no aparece

hay que cambiar «Nintendo NES-Famicom» por «Nintendo NES - Famicom» en "box", "preview" y "synopsis" del archivo config.json:

nano /mnt/mmc/MUOS/application/Artie/.artie/config.json
{
"dir": "NES",
"id": "3",
"name": "NES (Famicom)",
"box": "/mnt/mmc/MUOS/info/catalogue/Nintendo NES - Famicom/box/",
"preview": "/mnt/mmc/MUOS/info/catalogue/Nintendo NES - Famicom/preview/",
"synopsis": "/mnt/mmc/MUOS/info/catalogue/Nintendo NES - Famicom/text/"
},

mastersystem no aparece

si un sistema determinado no aparece entre las carpetas de "roms" (en este caso, /mnt/sdcard/ROMS), hay que modificar el parámetro "dir" correspondiente del archivo config.json: