Añadida información sobre el core de ColecoVision

doc/English ZXDOS+ and gomaDOS+ Manual.adoc

@@ -1,6 +1,6 @@
 = ZXDOS+ and gomaDOS+ Manual
 :author: kounch
-:revnumber: 1.1.4
+:revnumber: 1.1.5
 :doctype: book
 :front-cover-image: image::img/portada.jpg[]
 :email: kounch@users.noreply.github.com
@@ -810,7 +810,7 @@ To update esxdos to a new version, the distribution must be obtained from http:/
 
 Once downloaded and extracted, the contents of `BIN` and `SYS` directories have to be copied to the root of the card, merging the existing ones (to preserve the exclusive ZXDOS+ commands).
 
-Copy `ESXMMC.BIN` in the root of the microSD card, renaming it as `ESXDOS.ZX2` (for a ZXDOS+ with FPGA LX16 board) or `ESXDOS.ZXD` (for a ZXDOS+ with LX25 board).
+Copy `ESXMMC.BIN` (or `ESXMMC.ROM`, depending on version) to the root of the microSD card, renaming it as `ESXDOS.ZX2` (for a ZXDOS+ with FPGA LX16 board) or `ESXDOS.ZXD` (for a ZXDOS+ with LX25 board).
 
 Start ZXDOS + with the card inserted and press `F2` to access BIOS setup. Select the `Upgrade` menu and choose __"Upgrade esxdos for ZX"__. In the dialog that appears choose __"SD file"__ and, when it asks __"Load from SD"__ answer __"Yes"__ to the question __"Are you sure?"__. The content of the file `ESXDOS...` will be read, written to the flash storage and you will be notified when it is updated.
 
@@ -1346,6 +1346,53 @@ The following options are available:
 
 <<<
 
+=== ColecoVision
+
+https://en.wikipedia.org/wiki/ColecoVision[ColecoVision] is Coleco Industries' home video-game console that was released in August 1982.
+
+ZXDOS+ core is based on https://github.com/fbelavenuto/colecofpga[ZX-Uno version] by Fabio Belavenuto.
+
+Some features of this core are:
+
+- BIOS ROM is loaded from microSD card
+- Supports multicart ROM, also loaded from microSD
+- Only works with VGA
+
+==== microSD card format
+
+You need a microSD card with the first partition in FAT16 format to store ROM image files of the games to load and other needed files. These can be downloaded from https://github.com/fbelavenuto/colecofpga/tree/master/SD_Card[the original project in GitHub].
+
+See the <<_cores,corresponding section>> for instructions of how to install the ColecoVision core in ZXDOS+.
+
+==== Keyboard
+
+==== Special keys and buttons
+
+While the core is running:
+
+- Cursor or `Q`, `A`, `E`, `R` or joystick 1: Directional controls for player 1
+- `Z` or joystick 1 main fire button: Fire Button 1 for player 1
+- `U`, `J`, `O`, `P` or joystick 2: Directional controls for player 2
+- `M` or joystick 2 main fire button: Fire button 1 for player 2
+- `X` or joystick 1 secondary fire button: Fire button 1 for player 1 and player 2
+- `0` to `9`:  Button 0 to 9 for player 1 and player 2
+- `T`: Button '*'
+- `Y`: Button '#'
+- 'Esc' (or `Caps Shift+Space` on gomaDOS+, `PC XT` keyboard mode): Soft Reset
+
+<<<
+
+==== Basic Guide
+
+On startup, BIOS ROM is loaded from the card, and then the multicart ROM. 
+
+[.text-center] 
+image::img/coleco.jpg[pdfwidth=70%]
+
+At multicart menu, use the directional controls to choose one ROM, and then fire button 1 to load. Pressing 'Esc' (`Caps Shift+Space` on gomaDOS+, `PC XT` keyboard mode) restarts the core and loads the ROM selection menu again.
+
+<<<
+
 == Troubleshooting
 
 === Firmware recovery
@@ -1589,6 +1636,8 @@ http://www.zxuno.com/forum/viewtopic.php?f=16&t=4005[Teclado Core Atom]
 
 http://www.zxuno.com/forum/viewtopic.php?t=1245[Core de NES para ZX-Uno]
 
+https://github.com/fbelavenuto/colecofpga[ColecoFPGA on GitHub]
+
 https://catleytech.com/?p=2679[Programming a Spartan 6 with a Raspberry Pi]
 
 http://www.zxuno.com/forum/viewtopic.php?f=25&t=375[Tutorial para desbriquear el ZX-Uno con una Raspberry]

doc/Manual de ZXDOS+ y gomaDOS+.adoc

@@ -1,6 +1,6 @@
 = Manual de ZXDOS+ y gomaDOS+
 :author: kounch
-:revnumber: 1.1.4
+:revnumber: 1.1.5
 :doctype: book
 :front-cover-image: image::img/portada.jpg[]
 :email: kounch@users.noreply.github.com
@@ -808,7 +808,7 @@ Para actualizar esxdos a una nueva versión, se ha de obtener la distribución d
 
 Una vez descargado y descomprimido, se ha de copiar, a la raíz de la tarjeta, el contenido de los directorios `BIN` y `SYS` sobreescribiendo los existentes (para preservar los comandos exclusivos de ZXDOS+).
 
-Copiar `ESXMMC.BIN` en la raíz de la tarjeta microSD, renombrándolo como `ESXDOS.ZX2` (para un ZXDOS+ con placa FPGA LX16) o `ESXDOS.ZXD` (para un ZXDOS+ con placa FPGA LX25).
+Copiar `ESXMMC.BIN` (o `ESXMMC.ROM`, según la versión) en la raíz de la tarjeta microSD, renombrándolo como `ESXDOS.ZX2` (para un ZXDOS+ con placa FPGA LX16) o `ESXDOS.ZXD` (para un ZXDOS+ con placa FPGA LX25).
 
 Iniciar el ZXDOS+ con la tarjeta insertada y pulsar F2 para acceder a la configuración de BIOS. Seleccionar el menú `Upgrade` y elegir __"Upgrade esxdos for ZX"__. En el diálogo que aparece elegir __"SD file"__ y, cuando pregunte __"Load from SD"__ contestar __"Yes"__ a la pregunta __"Are you sure?"__. Se leerá el contenido del fichero `ESXDOS...`, se grabará en la flash y avisará cuando esté actualizado.
 
@@ -1344,6 +1344,53 @@ En él se pueden activar o desactivar las siguientes opciones:
 
 <<<
 
+=== ColecoVision
+
+https://es.wikipedia.org/wiki/ColecoVision[ColecoVision] es una consola de videojuegos lanzada al mercado por la empresa Coleco.
+
+La versión para ZXDOS+ está basada en la https://github.com/fbelavenuto/colecofpga[versión para ZX-Uno] de Fabio Belavenuto.
+
+Algunas de las características del core son:
+
+- La ROM de la BIOS se carga desde la tarjeta microSD
+- Soporta ROM multicartucho, que también se carga desde la microSD
+- Sólo funciona en VGA ¿?
+
+==== Formato de Tarjeta microSD
+
+Se debe de utilizar una tarjeta microSD, con la primera partición en formato FAT16, para almacenar los ficheros con las imágenes ROM y otros archivos necesarios. Los archivos se pueden descargar desde la https://github.com/fbelavenuto/colecofpga/tree/master/SD_Card[web del proyecto original en GitHub]
+
+Si no estuviera ya, <<_cores,instalar el core de ColecoVision>> en el ZXDOS+.
+
+==== Teclado
+
+==== Teclas especiales y botones
+
+Durante la ejecución del core:
+
+- Cursor o `Q`, `A`, `E`, `R` o el joystick 1: Controles de dirección del jugador 1
+- `Z` o el botón de joystick 1: Botón de disparo 1 del jugador 1
+- `U`, `J`, `O`, `P` o el joystick 2: Controles de dirección del jugador 2
+- `M` o el botón de joystick 2: Botón de disparo 1 del jugador 2
+- `X` o el botón secundario de joystick 1: Botón de disparo 2 del jugador 1 y del jugador 2
+- `0` a `9`:  Botones del 0 al 9 del jugador 1 y el jugador 2
+- `T`: Botón '*'
+- `Y`: Botón '#'
+- 'Esc' (o `Caps Shift+Espacio` en gomaDOS+, en modo de teclado `PC XT`): Soft Reset
+
+<<<
+
+==== Guía básica
+
+Al iniciar, la ROM de la BIOS se carga desde la tarjeta SD, así como la ROM multicartucho. 
+
+[.text-center] 
+image::img/coleco.jpg[pdfwidth=70%]
+
+En el menú multicartucho, usar los controles de dirección para elegir la ROM a cargar, y luego el botón de disparo 1 para cargar la ROM elegida. Pulsando `Esc` (`Caps Shift+Espacio` en gomaDOS+, en modo de teclado `PC XT`) se reinicia el core y se vuelve a cargar el menú de selección de ROM.
+
+<<<
+
 == Solución de problemas
 
 === Recuperación del firmware
@@ -1591,6 +1638,8 @@ http://www.zxuno.com/forum/viewtopic.php?f=16&t=4005[Teclado Core Atom]
 
 http://www.zxuno.com/forum/viewtopic.php?t=1245[Core de NES para ZX-Uno]
 
+https://github.com/fbelavenuto/colecofpga[ColecoFPGA en GitHub]
+
 https://catleytech.com/?p=2679[Programming a Spartan 6 with a Raspberry Pi]
 
 http://www.zxuno.com/forum/viewtopic.php?f=25&t=375[Tutorial para desbriquear el ZX-Uno con una Raspberry]