EXPLORADOR AMSTRAD CPC v2.4  -  para el M4 Board
Para la Asociacion de Usuarios de Amstrad (AUA)
por Raul Jimenez  -  licencia MIT

https://github.com/soyrauljimenez/Explorador-Amstrad-CPC


QUE ES
------
Explorador de ficheros en ROM para el M4 Board. Navega la microSD con
joystick, muestra los nombres de fichero completos -no recortados- y
arranca los juegos directamente al pulsar fuego sobre un .dsk, un .cpr
convertido desde disco o un snapshot .sna.

Mode 1 a 64 columnas con letra propia y cuatro colores. Nombres de
hasta 58 caracteres, 14 juegos por pagina.


CONTENIDO
---------
EXPLOR2.ROM    la ROM, 16 KB
INSTALAR.txt   esto


INSTALACION
-----------
1. Sube EXPLOR2.ROM a un slot libre del M4 (del 8 al 15 en un 6128;
   en un 464 hace falta ROM baja modificada). En la interfaz web del
   M4: pagina Roms, boton Upload del slot que elijas.

2. Reinicia el M4. Comprueba con  |M4HELP  que aparece en su slot.

3. En BASIC, escribe  |E

No hace falta ningun fichero en la tarjeta.


INSTALACION SIN WIFI, DESDE LA MICROSD
--------------------------------------
El M4 puede grabar en un slot una ROM que este en la tarjeta. Se hace
una sola vez: la ROM queda en la memoria del M4 igual que por la web.

1. Copia EXPLOR2.ROM en la raiz de la microSD desde el ordenador.

2. Con la tarjeta en el M4, escribe en el CPC:

       a$="EXPLOR2.ROM":|ROMUP,@a$,12

   El 12 es el slot; vale cualquiera libre. En un 6128 tambien sirve
   |ROMUP,"EXPLOR2.ROM",12 ; en un 464 el nombre tiene que ir en una
   variable con @, porque su BASIC no pasa cadenas a estos comandos.

3. Reinicia el M4 (o apaga y enciende), comprueba con  |M4HELP  que
   aparece y escribe  |E

Para actualizarlo, lo mismo con la ROM nueva sobre el mismo slot.


ARRANQUE AUTOMATICO (OPCIONAL)
------------------------------
Para que salga al encender, escribe en el Amstrad:

       NEW
       10 |E
       SAVE"AUTOEXEC.BAS"

El SAVE tiene que hacerse EN EL CPC: el arranque automatico necesita
el fichero tokenizado, que es lo que produce el SAVE del propio
interprete. Para quitarlo, borra AUTOEXEC.BAS de la tarjeta.

Si vienes de la v2.1 o anterior, graba este AUTOEXEC.BAS encima del
antiguo. A.BAS, E.BAS y EXPON ya no hacen falta: el arranque antiguo
sigue funcionando, pero solo lanza el explorador si EXPON vale 1, y
salir con ESC lo pone a 0.


USO
---
   Arriba / abajo ....... elegir
   Izquierda / derecha .. pagina
   FUEGO 1 / ENTER ...... abrir carpeta o EJECUTAR JUEGO
   L o FUEGO 1 un segundo sobre un juego: abrirlo sin lanzarlo, para
                          elegir a mano el fichero
   FUEGO 2 / DEL ........ volver atras
   F .................... buscar en esta carpeta
   G .................... buscar en toda la biblioteca
   C .................... configuracion: idioma
   ESC .................. volver a BASIC

F y G abren una ventana con el teclado del 464 en pantalla. Con el
joystick se elige tecla y FUEGO la pulsa: RET busca, DEL borra una
letra, CLR todo y ESC cierra. El teclado de verdad sirve igual.

G enseña lo encontrado como una carpeta mas, con la ruta delante.
Fuego abre un resultado y FUEGO 2 vuelve a donde estabas.

El idioma (castellano o ingles) se guarda en /EXPLOR.CFG.

Si un juego no arranca porque el explorador ha elegido mal el
cargador, reinicia con el boton CPC Reset del M4, vuelve al juego y
abrelo con L o con el fuego largo para elegir el fichero.

JUEGOS DE VARIOS DISCOS: al pulsar fuego sobre la primera cara
("Face A", "Side 1", "Cara A", "Disk 1 of 2"), el explorador junta los
ficheros de todas las caras en la carpeta /EXPLOR de la tarjeta y lanza
el juego desde ahi. Cuando pide la otra cara, ya la tiene. Vale para
los juegos que cargan sus ficheros por el nombre; los protegidos, que
leen el disco sector a sector, no.

Los .sna los carga el |SNA del propio M4. Un snapshot solo funciona en
una maquina con las mismas ROMs que la que lo saco: uno de un 464
original se cuelga en un 464 con ROM baja de 6128 en cuanto el juego
llama al firmware.

De los .cpr convertidos desde disco, el M4 solo lee bien los de formato
sistema; con los demas el explorador avisa: "Este .cpr no lo lee bien
el M4".

Los .cpr que son cartuchos de verdad solo funcionan en un CPC Plus:
el explorador lo avisa y no los abre.


NOTAS
-----
Arranca en la carpeta /ROMS y no deja subir por encima.

El slot donde viva la ROM del M4 se detecta solo, asi que da igual
que la tengas en el 6, el 7 o donde sea.

Probado en un CPC 464 con ROM baja de 6128. Si lo usas en otra
configuracion, cuenta que tal en el repositorio.
