RG40XXV – cuaderno de campo

Puesto al día el 12 de octubre 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

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: