RA for running ColecoVision

Author: eduardofilo

README.md

@@ -173,7 +173,7 @@ Below is the table of the systems configured in SimpleMenu with the paths where
 |Atari 5200|roms/A5200|bin, a52, zip, 7z|
 |Atari 7800|roms/A7800|bin, a78, zip, 7z|
 |Inteillivision|roms/INTELLI|int|
-|ColecoVision|roms/COLECO|rom, col|
+|ColecoVision|roms/COLECO|col, cv, bin, rom, zip, 7z|
 |SNK Neo Geo|roms/NEOGEO|zip, 7z|
 |NEC PC Engine|roms/PCE|pce, tg16, cue, zip, 7z|
 |NEC PC Engine CD|roms/PCECD|pce, tg16, cue, chd, zip, 7z|
@@ -210,12 +210,31 @@ ROMs in `cue+bin` format do not work compressed in ZIP. On the contrary, in `iso
 
 #### ScummVM
 
+From version 1.4, the way to install the games for this system differs a lot between using the RetroArch core or the standalone emulator. It will be necessary to opt for one or the other emulator from the beginning and proceed as indicated below:
+
+##### RetroArch
+
 ScummVM games are made up of several files, so they will have to be kept in directories. The extension `svm` indicated in the former list corresponds to an empty file whose name is the ID of the game that we will extract from [this list](https://www.scummvm.org/compatibility/) and that we will place in the directory where we have the rest of the game files. For example, for the game "The Secret of Monkey Island" we will need the files that we can consult in the [ScummVM wiki](https://wiki.scummvm.org/index.php?title=Category:Supported_Games). Specifically for this game [we see](https://wiki.scummvm.org/index.php?title=The_Secret_of_Monkey_Island) that we will need the files `MONKEY.000` and `MONKEY.001` that we will place in a directory of any name within the directory configured in SimpleMenu (`<EXT_SD>/roms/SCUMMVM`). It will be in this same directory where we will have to place the empty file `svm`. According to the ScummVM compatibility list, the ID of "The Secret of Monkey Island" is `monkey`, so the file that we will place inside the game directory will be `monkey.svm`. Finally, if we want SimpleMenu to show the full name of the game, we will only have to incorporate an entry like the following in the SimpleMenu alias file (`/home/media/data/local/.simplemenu/alias.txt`):
 
 ```
 monkey=The Secret of Monkey Island
 ```
 
+##### Standalone
+
+This emulator incorporates a self-installation system. For the system to work we have to create an empty file named `detect.svm` in the root of the directory where we have all the games. In Adam that directory will be `<EXT_SD>/roms/SCUMMVM`. We can create the file from the computer for example. Once the file is installed, we will start the console and access the ScummVM system in SimpleMenu. In the list of games we should only see the newly created file. We'll set the emulator `scummvm-2.5.1-gcw0.opk` to launch that file and open it. After a few seconds we will return to SimpleMenu where we should see the games that we had in the directory of this system correctly installed.
+
+![ScummVM autodetect 1](images/scummvm_autodetect1.png)
+
+![ScummVM autodetect 2](images/scummvm_autodetect2.png)
+
+This self-install system does two things:
+
+1. It generates the `.svm` files that act as game launchers and it does so with long names, so it will not be necessary to update the SimpleMenu `alias.txt` file as commented in the instructions given for the ScummVM RetroArch core.
+2. It generates the `.scummvmrc` file in the home directory of the main system partition (on the internal card), so if you reinstall the image you have to remember to back up this file or repeat the auto-install system.
+
+We will have to remember to configure the games that will have appeared in the list to be launched from the standalone emulator, just as we did with the `detect.svm` file, which by the way we can already delete since it will no longer be necessary.
+
 #### Quake
 
 The four directories configured in this system respect the structure necessary for the different Expansion Paks that are described [here](https://docs.libretro.com/library/tyrquake/#loading-quake-and-expansion-paks). The names of the files (`pak0.pak`, `pak1.pak`, ...) within the different directories cannot be changed, but the previews can be used to distinguish one from the other.

README_es.md

@@ -173,7 +173,7 @@ A continuación se muestra la tabla de los sistemas configurados en SimpleMenu c
 |Atari 5200|roms/A5200|bin, a52, zip, 7z|
 |Atari 7800|roms/A7800|bin, a78, zip, 7z|
 |Inteillivision|roms/INTELLI|int|
-|ColecoVision|roms/COLECO|rom, col|
+|ColecoVision|roms/COLECO|col, cv, bin, rom, zip, 7z|
 |SNK Neo Geo|roms/NEOGEO|zip, 7z|
 |NEC PC Engine|roms/PCE|pce, tg16, cue, zip, 7z|
 |NEC PC Engine CD|roms/PCECD|pce, tg16, cue, chd, zip, 7z|
@@ -210,12 +210,31 @@ Las ROMs en formato `cue+bin` no funcionan comprimidas en ZIP. En formato `iso`
 
 #### ScummVM
 
+A partir de la versión 1.4, la forma de instalar los juegos para este sistema difiere mucho entre utilizar el core RetroArch o el emulador standalone. Habrá que decantarse desde un principio por uno u otro emulador y proceder como se indica a continuación:
+
+##### RetroArch
+
 Los juegos ScummVM están compuestos de varios ficheros, por lo que habrá que mantenerlos en directorios. La extensión `svm` indicada en la lista anterior corresponde a un fichero vacío que tenga como nombre el ID del juego que extraeremos de [esta lista](https://www.scummvm.org/compatibility/) y que colocaremos en el directorio donde tengamos el resto de los ficheros del juego. Por ejemplo para el juego "The Secret of Monkey Island" necesitaremos los ficheros que podemos consultar en el [wiki de ScummVM](https://wiki.scummvm.org/index.php?title=Category:Supported_Games). En concreto para este juego [vemos](https://wiki.scummvm.org/index.php?title=The_Secret_of_Monkey_Island) que necesitaremos los ficheros `MONKEY.000` y `MONKEY.001` que colocaremos en un directorio de cualquier nombre dentro del directorio configurado en SimpleMenu (`<EXT_SD>/roms/SCUMMVM`). Será en este mismo directorio donde tendremos que colocar el fichero vacío `svm`. Según la lista de compatibilidad de ScummVM, el ID de "The Secret of Monkey Island" es `monkey`, por lo que el fichero que colocaremos dentro del directorio del juego será `monkey.svm`. Por último, si queremos que SimpleMenu muestre el nombre completo del juego, sólo tendremos que incorporar una entrada como la siguiente en el fichero de alias de SimpleMenu (`/home/media/data/local/.simplemenu/alias.txt`):
 
 ```
 monkey=The Secret of Monkey Island
 ```
 
+##### Standalone
+
+Este emulador incorpora un sistema de autoinstalación. Para que el sistema funcione tenemos que crear un fichero vacío de nombre `detect.svm` en la raíz del directorio donde tengamos todos los juegos. En Adán ese directorio será `<EXT_SD>/roms/SCUMMVM`. Podemos crear el fichero desde el ordenador por ejemplo. Una vez instalado el fichero, arrancaremos la consola y accederemos al sistema ScummVM en SimpleMenu. En el listado de juegos sólo deberíamos ver el fichero recién creado. Ajustaremos el emulador `scummvm-2.5.1-gcw0.opk` para lanzar ese fichero y lo abriremos. Tras unos segundos volveremos a SimpleMenu donde deberíamos ver correctamente instalados los juegos que teníamos en el directorio de este sistema.
+
+![ScummVM autodetect 1](images/scummvm_autodetect1.png)
+
+![ScummVM autodetect 2](images/scummvm_autodetect2.png)
+
+Este sistema de autoinstalación hace dos cosas:
+
+1. Genera los ficheros `.svm` que actúan como lanzadores de los juegos y lo hace con nombres largos, por lo que no será necesario actualizar el fichero `alias.txt` de SimpleMenu como se comentaba en las instrucciones dadas para el core RetroArch de ScummVM.
+2. Genera el fichero `.scummvmrc` en el directorio home de la partición principal del sistema (en la tarjeta interna), por lo que en caso de volver a instalar la imagen hay que acordarse de respaldar este fichero o repetir el sistema de autoinstalación.
+
+Habrá que acordarse de configurar los juegos que habrán aparecido en el listado para ser lanzados desde el emulador standalone al igual que hicimos con el fichero `detect.svm` que por cierto ya podremos borrar puesto que ya no será necesario.
+
 #### Quake
 
 Los cuatro directorios configurados en este sistema respetan la estructura necesaria para los distintos Expansion Paks que se describen [aquí](https://docs.libretro.com/library/tyrquake/#loading-quake-and-expansion-paks). Los nombres de los ficheros (`pak0.pak`, `pak1.pak`, ...) dentro de los distintos directorios, no se puede cambiar, pero se pueden usar las previews para distinguir unos de otros.

images/scummvm_autodetect1.png

@@ -86,9 +86,9 @@ romExts = .int,.bin
 scaling = 0
 
 [COLECOVISION]
-execs = /media/data/apps/ColecoD_2013-06-15-launcher.opk
+execs = /media/data/apps/retroarch_rg350_COLECO.opk,/media/data/apps/ColecoD_2013-06-15-launcher.opk
 romDirs = /media/sdcard/roms/COLECO/
-romExts = .rom,.col
+romExts = .col,.cv,.bin,.rom,.zip,.7z
 scaling = 0
 
 [NEO GEO]