====== ArkOS ======
**ArkOS** (cuyo nombre significa //Another RocKchip Operating System//) es un firmware personalizado basado en Ubuntu y Linux diseñado específicamente para consolas de videojuegos portátiles retro.
El proyecto original de ArkOS dejó de recibir actualizaciones oficiales y fue sucedido por dArkOS para esta consola
* [[https://github.com/christianhaitian/arkos|Repositorio oficial]]
* [[https://github.com/AeolusUX/ArkOS-R3XS|ArkOS - R3XS]]: versión de ArkOS mantenida por la comunidad centrada en las consolas R35S, R36S, PowKiddy, RGB20S.
* [[https://github.com/christianhaitian/arkos/wiki/ArkOS-Emulators-and-Ports-information|ArkOS Emulators and Ports information]]
===== Instalación =====
* [[https://github.com/AeolusUX/ArkOS-R3XS/releases|Descargar la versión correspondiente a R36S]]
* Descomprimir (de ''.xz'' a ''.img'')
* Grabar la imagen en una tarjeta micro SD (con ''[[informatica:sistemas_operativos:linux:coreutils:dd|dd]]'', por ejemplo). Es una imagen de 8 GB aproximadamente.
* Introducir la tarjeta en la R36S en el slot ''TF1-OS'' (el de la derecha).
* Encender la R36S.
* En el primer inicio se redimensionarán las particiones automáticamente.
* Tras la inicialización, se mostrará el logo de ArkOS.
Si durante el arranque, la pantalla no muestra nada, es probable que tengamos una de las pantallas nuevas y tengamos que sustituir los ficheros de la partición BOOT por los que podemos encontrar en este repositorio: https://github.com/AeolusUX/R36S-DTB
Lo primero que hay que hacer es identificar el tipo de panel. Si aún conservamos una imagen de la tarjeta SD original (la que venía con la consola), podemos entrar en esta web https://r36s.dpdns.org/dtbTools.html y subir el fichero ''rk3326-r35s-linux.dtb''. Nos dirá qué panel es. Por ejemplo, si dice **This is Panel 3**, iremos al repositorio anterior, en el directorio https://github.com/AeolusUX/R36S-DTB/tree/main/New%20Screens/Panel%203 para descargar el fichero ''rk3326-r35s-linux.dtb'' y sustituirlo por el que tengamos en la instalación de ArkOS (partición ''BOOT'').
Otra opción para identificar la consola que tenemos es quitar la batería y ver lo que está escrito en la placa. Algo como ''R36S-V12 2023-08-18''.
Si usamos la configuración de dos tarjetas:
* Insertar la segunda tarjeta en el slot ''TF2-GAME'' (el de la izquierda)
* Navegar a //Options// > //Advanced// > **SWITCH TO SD2 FOR ROMS**
Esta acción creará los directorios necesarios para las ROMS en ambas tarjetas.
La tarjeta debe estar previamente formateada en FAT, FAT32, exFat, EXT4 o NTFS
===== Controles / Botones =====
Desde la [[https://aeolusux.github.io/ArkOS-R3XS/|versión comunitaria]] de febrero de 2024, el botón Fn ha pasado a comportarse como SELECT (//Hotkey// para [[informatica:software:retroarch|RetroArch]])
* Fn + ↑ / ↓: subir / bajar brillo.
* Power: poner el dispositivo en suspensión (//sleep//)
* Fn + Power: apagar dispositivo
Durante la emulación:
* START + Fn (2 veces seguidas): sale del juego.
* Fn + X: menú RetroArch
* Fn + %%A%%: pausar / reanudar el juego.
* Fn + B: reiniciar el juego
* Fn + R1: guardar estado
* Fn + L1: cargar estado
* Fn + ↑ / ↓: elegir //slot// de guardado.
* Fn: avance rápido
Durante la emulación de Nintendo DS:
* L2 + R2: alterna la vista simultánea de dos pantallas
* Fn: Alterna entre pantallas
* L3 + R3: muestra el menú de DraStic (el emulador de Nintendo DS)
L3 y R3 se refiere a pulsar el botón que tienen los controles analógicos izquierdo y derecho, respectivamente (no solo sirven para moverse).
[[https://github.com/christianhaitian/arkos/wiki/Frequently-Asked-Questions---rg353v#a-see-hotkey-information-below|Botones y funciones en ArkOS]]
===== Actualización =====
Lo más cómodo es conectar la R36S a Internet (mediante algún adaptador WiFi o compartiendo la conexión desde un teléfono vía cable USB enchufándolo al puerto OTG).
En ArkOS, vamos a las Opciones -> Update...
Completar las notas de esta sección.
===== Añadir juegos =====
Dentro de la partición ''EASYROMS'' de la tarjeta SD encontraremos carpetas para los diferentes sistemas emulados.
Por ejemplo, si queremos meter roms de Super Nintendo, las copiaremos en la carpeta ''snes''
===== Añadir BIOS =====
Dentro de la partición ''EASYROMS'' de la tarjeta SD encontraremos la carpeta ''bios''. Dentro de ella tendremos que copiar todas las bios de los sistemas que queramos.
* [[https://github.com/Abdess/retroarch_system/tree/libretro|Compilación de BIOS para diferentes plataformas de emulación]]
===== Añadir imágenes de juegos =====
Para añadir imágenes o vídeos de los juegos, debemos meterlas en ''/media/images/''??.
Para no hacer este proceso manualmente, se puede utilizar la opción de //scrape// de EmulationStation (desde la propia consola, aunque es necesario utilizar un adaptador Wi-Fi o compartir datos desde un móvil mediante USB C para conectarnos a Internet). Sin embargo, lo más cómodo es hacer el proceso de //scraping// desde un PC con el programa [[https://www.skraper.net/|Skraper]] (se puede usar en Linux mediante [[informatica:sistemas_operativos:linux:software:wine|WINE]]) y una cuenta de [[https://www.screenscraper.fr/|ScreenScraper]].
En caso de que luego no se muestren en EmulationStation, vamos a las opciones > ADVANCED SETTINGS y activamos SEARCH FOR LOCAL ART.
===== Añadir temas de EmulationStation =====
Descomprimirlos en ''EASYROMS/themes/''.
* https://github.com/Jetup13/Emulationstation-OGA-Theme-Gallery
==== Cambiar imagen de fondo ====
Para modificar la imagen que se muestra al encender la consola, basta con crear un fichero llamado ''boot.bmp'' con las siguientes características:
* Resolución: 640x480
* Formato: BMP
* Profundidad de bits: 24
La copiamos en la partición ''BOOT'' de la tarjeta micro SD.
==== Portmaster ====
ArkOS (al menos en su versión comunitaria) incluye [[https://portmaster.games/|Portmaster]], una herramienta para descargar versiones Linux de varios juegos.
Desde el menú principal de EmulationStation nos dirigimos a //Tools// -> **Portmaster**. Será necesaria una conexión a Internet activa desde la R36S. La primera vez que entremos en Portmaster seguramente nos pida instalar una actualización.
Podemos descargar manualmente //ports// desde la [[https://portmaster.games/games.html|web de PortMaster]] filtrando por **Game Console** = //R36S Retro Handheld//. Para instalarlos, descomprimos el ''.zip'' en la carpeta ''EASYROMS/ports/''.
==== Pico-8 ====
Los juegos se guardan en el directorio ''pico-8/carts'' y se admiten las extensiones ''.png'', ''.PNG'', ''.p8'' y ''.P8''.
Para salir de Pico-8 en cualquier momento, hay que presionar a la vez SELECT y START.
* https://github.com/christianhaitian/arkos/wiki/ArkOS-Emulators-and-Ports-information#pico-8
Ejemplo de fichero ''gamelist.xml'' para poder mostrar descripción e imágenes de los juegos de Pico-8:
relative path to your game
name of your game
description of what your game is
./images/filename of your image
Si tenemos una copia comprada de Pico-8, podemos descomprimir el contenido en ''roms/pico-8'' y los juegos se lanzarán con Pico-8 en lugar de Fake-08. Podemos descargar estos ficheros desde https://www.lexaloffle.com/dl/7tiann/pico-8_0.2.6b_raspi.zip.
* [[https://github.com/christianhaitian/arkos/wiki/ArkOS-Emulators-and-Ports-information#pico-8|Notas de la wiki de ArkOS sobre Pico-8]]
==== PPSSPP: emulador de PSP ====
Para acceder a la configuración, cuando estemos con un juego, pulsamos R3
==== Menú RetroArch ====
Pulsando SELECT + X.
También es posible pulsando a la vez L3 + R3 (los botones de los joystick analógicos).
==== Mantener relación de aspecto en los juegos ====
Por defecto, RetroArch viene configurado para que los juegos ocupen toda la pantalla (''4:3'').
Podemos indicar
Vamos al menú de RetroArch con SELECT + X. Cerramos el juego con "Close content". Ahora vamos a //Settings// -> //Video// -> //Scaling// -> //Aspect Ratio//. Al pulsar, nos aparecerán distintas opciones y marcaremos la de "Core provided". Para guardar estos ajustes, volvemos al inicio y //Configuration File// y pulsamos en Save Current Configuration.
==== Juegos Arcade ====
La emulación de máquinas recreativas (//arcade//) es delicada. Para mejores resultados, se deberían usar roms del romset que coincida con el emulador.
Por ejemplo, el pack [[https://archive.org/details/tiny-best-set-go|Tiny Best Set: GO]] viene del romset de Mame 2003 plus, así que en la R36S tendremos que meter esas roms en ''EASYROMS/mame2003/mame2003-plus/''
Sin embargo, la carpeta ''EASYROMS/arcade'' es la que usa el //core// de Fina Burn Neo. FBNeo necesita un r romset distinto que se diseñó específicamente para él. Como indican [[https://github.com/christianhaitian/arkos/wiki/ArkOS-Emulators-and-Ports-information#arcade|aquí]], es necesario el romset de FBAlpha ''v0.2.97.44'' (''v0.2.97.40'', ''v0.2.97.42'' y ''v0.2.97.43'' podrían funcionar también).