diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.adoc b/doc/English ZXDOS+ and gomaDOS+ Manual.adoc index f7c4158..6f5506a 100644 --- a/doc/English ZXDOS+ and gomaDOS+ Manual.adoc +++ b/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] diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.pdf b/doc/English ZXDOS+ and gomaDOS+ Manual.pdf index 8884f87..c798576 100644 Binary files a/doc/English ZXDOS+ and gomaDOS+ Manual.pdf and b/doc/English ZXDOS+ and gomaDOS+ Manual.pdf differ diff --git a/doc/Manual de ZXDOS+ y gomaDOS+.adoc b/doc/Manual de ZXDOS+ y gomaDOS+.adoc index da4494c..473fbce 100644 --- a/doc/Manual de ZXDOS+ y gomaDOS+.adoc +++ b/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] diff --git a/doc/Manual de ZXDOS+ y gomaDOS+.pdf b/doc/Manual de ZXDOS+ y gomaDOS+.pdf index dfae1bd..65c6e7f 100644 Binary files a/doc/Manual de ZXDOS+ y gomaDOS+.pdf and b/doc/Manual de ZXDOS+ y gomaDOS+.pdf differ