This commit is contained in:
antoniovillena 2020-10-04 00:41:33 +02:00
commit aca36143d0
7 changed files with 77279 additions and 5428 deletions

File diff suppressed because it is too large Load Diff

File diff suppressed because one or more lines are too long

View File

@ -1,12 +1,13 @@
= Manual de ZXDOS+ y gomaDOS+ = Manual de ZXDOS+ y gomaDOS+
:author: kounch :author: kounch
:revnumber: 1.0.0 :revnumber: 1.0.3
:doctype: book :doctype: book
:email: kounch@users.noreply.github.com :email: kounch@users.noreply.github.com
:Revision: 1.0 :Revision: 1.0
:description: Manual en castellano de ZXDOS+ y gomaDOS+ :description: Manual en castellano de ZXDOS+ y gomaDOS+
:keywords: Manual, Castellano, ZXDOS+, gomaDOS+ :keywords: Manual, Castellano, ZXDOS+, gomaDOS+
:icons: font :icons: font
:source-highlighter: rouge
:toc: left :toc: left
:toc-title: Índice :toc-title: Índice
:toclevels: 4 :toclevels: 4
@ -17,6 +18,8 @@
ZXDOS+ y gomaDOS+ son la continuación de http://zxuno.speccy.org[ZX-Uno] un proyecto de hardware y software basado en una placa FPGA programada para trabajar como un ordenador ZX Spectrum, y creado por el equipo de ZX-Uno: Superfo, AVillena, McLeod, Quest y Hark0. ZXDOS+ y gomaDOS+ son la continuación de http://zxuno.speccy.org[ZX-Uno] un proyecto de hardware y software basado en una placa FPGA programada para trabajar como un ordenador ZX Spectrum, y creado por el equipo de ZX-Uno: Superfo, AVillena, McLeod, Quest y Hark0.
Con el paso del tiempo, el proyecto ha ido creciendo, de forma que es posible instalar distintas configuraciones de software (cores) en la memoria flash de la FPGA, y que trabajan como otros sistemas distintos del ZX Spectrum, pudiendo elegir arrancar el ZXDOS+ con la configuración que se desee de entre todas las instaladas.
La página oficial de ZXDOS+ y gomaDOS+ es http://zxdos.forofpga.es. La página oficial de ZXDOS+ y gomaDOS+ es http://zxdos.forofpga.es.
La mayoría de las funciones y características de ZXDOS+ y gomaDOS+ son las mismas, así que, en este documento, se hablará, en general, de ZXDOS+, indicando las diferencias con gomaDOS+ donde sea necesario. La mayoría de las funciones y características de ZXDOS+ y gomaDOS+ son las mismas, así que, en este documento, se hablará, en general, de ZXDOS+, indicando las diferencias con gomaDOS+ donde sea necesario.
@ -40,7 +43,7 @@ Para poder aprovechar todo su potencial, es útil tener también:
==== Formato de la tarjeta microSD ==== Formato de la tarjeta microSD
Para poder utilizar una tarjeta microSD, esta debe tener, al menos, una partición (la primera en el caso de haber varias) en formato FAT16 o FAT32 (según el caso, se recomienda uno u otro formato para compatibilidad con algunos cores de terceros). Para poder utilizar una tarjeta microSD, esta debe tener, al menos, una partición (la primera en el caso de haber varias) en formato FAT16 o FAT32 (según el caso, se recomienda uno u otro formato para compatibilidad con distintos cores de terceros).
[NOTE] [NOTE]
==== ====
@ -67,7 +70,7 @@ diskutil unmountDisk /dev/disk6
diskutil partitionDisk /dev/disk6 MBR "MS-DOS FAT16" ZXDOSPLUS R diskutil partitionDisk /dev/disk6 MBR "MS-DOS FAT16" ZXDOSPLUS R
---- ----
Para dividirla en dos particiones iguales (si la tarjeta es de 4GB o menos de tamaño) Para dividirla en dos particiones iguales (si la tarjeta es de 4GB o menos de tamaño):
[source,shell] [source,shell]
---- ----
@ -75,7 +78,8 @@ diskutil unmountDisk /dev/disk6
diskutil partitionDisk /dev/disk6 MBR "MS-DOS FAT16" ZXDOSPLUS 50% "MS-DOS FAT16" EXTRA 50% diskutil partitionDisk /dev/disk6 MBR "MS-DOS FAT16" ZXDOSPLUS 50% "MS-DOS FAT16" EXTRA 50%
---- ----
Para crear dos primeras particiones FAT16 de 4GB (por ejemplo, para usar con el core de MSX) y usar el resto del espacio con otra más en formato FAT32 (para tarjetas de más de 8GB) Para crear dos primeras particiones FAT16 de 4GB (por ejemplo, para usar con el core de MSX) y usar el resto del espacio con otra más en formato FAT32 (para tarjetas de más de 8GB):
[source,shell] [source,shell]
---- ----
diskutil unmountDisk /dev/disk6 diskutil unmountDisk /dev/disk6
@ -89,7 +93,8 @@ sudo newfs_msdos -F 16 -v EXTRA -b 4096 -c 128 /dev/rdisk6s2
El comando `diskutil` no permite crear particiones FAT16 de más de 2G de tamaño y formatearlas a la vez. Por eso, en el último caso, se crean primero las particiones y luego se formatean en FAT16. El comando `diskutil` no permite crear particiones FAT16 de más de 2G de tamaño y formatearlas a la vez. Por eso, en el último caso, se crean primero las particiones y luego se formatean en FAT16.
==== ====
Para crear una partición FAT32 de 4GB (por ejemplo, para usar con el core de Amstrad CPC) y usar el resto del espacio con otra más en formato FAT32 (para tarjetas de más de 4GB de tamaño) Para crear una partición FAT32 de 4GB (por ejemplo, para usar con el core de Amstrad CPC) y usar el resto del espacio con otra más en formato FAT32 (para tarjetas de más de 4GB de tamaño):
[source,shell] [source,shell]
---- ----
diskutil unmountDisk /dev/disk6 diskutil unmountDisk /dev/disk6
@ -119,11 +124,14 @@ image::./img/esxdos.png[pdfwidth=70%]
<<< <<<
Es recomendable, además, añadir los comandos esxdos específicos para ZXDOS+. Estos se pueden obtener en la https://github.com/zxdos/zxuno/tree/master/SD[página con el código fuente del proyecto], y son los siguientes: Es recomendable, además, añadir los comandos esxdos específicos para ZXDOS+. Estos se pueden obtener en la página con el código fuente del proyecto (https://github.com/zxdos/zxuno/tree/master/SD[aquí] y https://github.com/zxdos/zxuno/tree/master/[aquí]), y son los siguientes:
back16m
back32m back32m
core corebios
dmaplayw dmaplayw
esprst
iwconfig
joyconf joyconf
keymap keymap
loadpzx loadpzx
@ -131,11 +139,12 @@ Es recomendable, además, añadir los comandos esxdos específicos para ZXDOS+.
playrmov playrmov
romsback romsback
romsupgr romsupgr
upgr16m
upgr32m upgr32m
zxuc zxuc
zxunocfg zxunocfg
<<#_comandos_para_zx_uno_y_zxdos,Más adelante>> se explica lo que hace cada uno de ellos. <<#_comandos_para_zxdos+,Más adelante>> se explica lo que hace cada uno de ellos.
<<< <<<
@ -152,7 +161,7 @@ image::img/bios.png[pdfwidth=70%]
En la primera pantalla de configuración, además de poder ejecutar distintas pruebas, se puede definir el comportamiento por defecto para lo siguiente: En la primera pantalla de configuración, además de poder ejecutar distintas pruebas, se puede definir el comportamiento por defecto para lo siguiente:
- Arranque silencioso (Quiet Boot): Para ocultar (o no) la pantalla que aparece al encender - Espera en el arranque (Boot Timer): Indica el tiempo que está la pantalla de arranque disponible (o la oculta por completo)
- Comprobar CRC de las ROMs (Check CRC): Para comprobar la integridad de las ROMs al cargarlas (más seguro) u omitirla (más rápido) - Comprobar CRC de las ROMs (Check CRC): Para comprobar la integridad de las ROMs al cargarlas (más seguro) u omitirla (más rápido)
- Tipo de teclado (Keyboard) - Tipo de teclado (Keyboard)
- Timing: Para definir el comportamiento de la ULA (Modo 48K, Modo 128K, Modo Pentagon) - Timing: Para definir el comportamiento de la ULA (Modo 48K, Modo 128K, Modo Pentagon)
@ -168,7 +177,7 @@ Se puede consultar información más tecnica en http://www.zxuno.com/wiki/index.
[.text-center] [.text-center]
image::img/bios2.png[pdfwidth=70%] image::img/bios2.png[pdfwidth=70%]
La segunda pantalla muestra las ROM de ZX Spectrum instaladas y permite reordenar (Move Up, Move Down), renombrar (Rename) o borrar (Delete) cada una de ellas, así como elegir la que se cargará por defecto en el arranque (Set Active). La segunda pantalla muestra las ROMs de ZX Spectrum instaladas y permite reordenar (Move Up, Move Down), renombrar (Rename) o borrar (Delete) cada una de ellas, así como elegir la que se cargará por defecto en el arranque (Set Active).
==== Upgrade ==== Upgrade
@ -193,7 +202,7 @@ image::img/bios5.png[pdfwidth=70%]
La pantalla de configuración avanzada sirve para modificar los siguientes ajustes: La pantalla de configuración avanzada sirve para modificar los siguientes ajustes:
- Distribución del teclado (Keyb Layout): Ver <<_tecado,el apartado correspondiente >> para más información) - Distribución del teclado (Keyb Layout): Ver <<_teclado,el apartado correspondiente >> para más información)
- Comportamiento del joystick emulado con el teclado numérico (Joy Keypad): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek o Fuller - Comportamiento del joystick emulado con el teclado numérico (Joy Keypad): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek o Fuller
- Comportamiento de un joystick conectado al puerto (Joy DB9): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek, Fuller o simular las teclas `Q`, `A`, `O`, `P`, `Espacio` y `M` - Comportamiento de un joystick conectado al puerto (Joy DB9): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek, Fuller o simular las teclas `Q`, `A`, `O`, `P`, `Espacio` y `M`
- Salida de vídeo (Video): PAL, NTSC o VGA - Salida de vídeo (Video): PAL, NTSC o VGA
@ -218,23 +227,24 @@ Finalmente, desde la última pantalla se puede:
== ZX Spectrum == ZX Spectrum
El core principal es el que implementa un ordenador ZX Spectrum. Estas son algunas de sus principales características: El core principal es el que implementa un ordenador ZX Spectrum. Este core es especial, y no se puede sustibuir por otro que no sea de ZX Spectrum, ya que el ZXDOS+ lo utiliza para su funcionamiento.
Estas son algunas de sus principales características:
- Implementación ZX Spectrum 48K, 128K, Pentagon y Chloe 280SE - Implementación ZX Spectrum 48K, 128K, Pentagon y Chloe 280SE
- ULA con modos ULAplus, Timex y modo Radastan (incluyendo scroll por hardware y grupo de paleta seleccionable) - ULA con modos ULAplus, Timex y modo Radastan (incluyendo scroll por hardware y grupo de paleta seleccionable)
- Posibilidad de desactivar la contención de memoria (para compatibilidad con Pentagon 128) - Posibilidad de desactivar la contención de memoria (para compatibilidad con Pentagon 128)
- Posibilidad de elegir el comportamiento del teclado (issue 2 o issue 3) - Posibilidad de elegir el comportamiento del teclado (issue 2 o issue 3)
- Posibilidad de elegir el timing de la ULA (48K, 128K o Pentagon) - Posibilidad de elegir el timing de la ULA (48K, 128K o Pentagon)
- Control del encuadre de pantalla configurable para tipo de timing, y posibilidad de elegir entre sincronismos originales de Spectrum o sincronismos - estándar PAL progresivo. - Control del encuadre de pantalla configurable para tipo de timing, y posibilidad de elegir entre sincronismos originales de Spectrum o sincronismos estándar PAL progresivo.
- Soporte de la MMU horizontal del Timex con bancos HOME, DOC y EXT en RAM. - Soporte de la MMU horizontal del Timex con bancos HOME, DOC y EXT en RAM.
- Interrupción ráster programable en número de línea, para cualquier linea de TV. - Interrupción ráster programable en número de línea, para cualquier linea de TV.
- Posibilidad de activar/desactivar los registros de manejo de bancos de memoria, para mejor compatibilidad con cada modelo implementado - Posibilidad de activar/desactivar los registros de manejo de bancos de memoria, para mejor compatibilidad con cada modelo implementado
- Posibilidad de activar/desactivar los dispositivos incorporados al core para mejorar la compatibilidad con ciertos programas - Posibilidad de activar/desactivar los dispositivos incorporados al core para mejorar la compatibilidad con ciertos programas
- Soporte ZXMMC para +3e - Soporte ZXMMC para +3e y soporte DIVMMC para esxdos y firmwares compatibles
- Soporte DIVMMC para esxdos y firmwares compatibles
- Soporte Turbo Sound - Soporte Turbo Sound
- Soporte de SpecDrum - Soporte de SpecDrum
- Cada canal A,B,C de los dos chips AY-3-8912, beeper y SpecDrum pueden dirigirse a las salidas izquierda, derecha, ambas o ninguna, permitiendo la - implementación de configuraciones tales como ACB, ABC, etc. - Cada canal A,B,C de los dos chips AY-3-8912, beeper y SpecDrum pueden dirigirse a las salidas izquierda, derecha, ambas o ninguna, permitiendo la implementación de configuraciones tales como ACB, ABC, etc.
- Soporte de joystick real y joystick en teclado con protocolo Kempston, Sinclair 1 y 2, Cursor, Fuller y QAOPSpcM. - Soporte de joystick real y joystick en teclado con protocolo Kempston, Sinclair 1 y 2, Cursor, Fuller y QAOPSpcM.
- Soporte de modo turbo a 7MHz, 14MHz, 28MHz - Soporte de modo turbo a 7MHz, 14MHz, 28MHz
- Soporte de teclado con protocolo PS/2 y mapeado configurable por el usuario desde el propio Spectrum. - Soporte de teclado con protocolo PS/2 y mapeado configurable por el usuario desde el propio Spectrum.
@ -245,13 +255,13 @@ El core principal es el que implementa un ordenador ZX Spectrum. Estas son algun
=== Teclado === Teclado
El mapa se cambia desde el menú `Advanced` de la BIOS. Existen tres mapas distintos a elegir: Español (por defecto), inglés, y Spectrum (avanzado). El mapa de teclado (asignación de las teclas físicas del teclado con las pulsaciones que se presentan a los distinto cores) se cambia desde el menú `Advanced` de la BIOS. Existen tres mapas distintos a elegir: Español (por defecto), inglés, y Spectrum (avanzado).
También se puede cambiar con la utilidad `keymap`. Dentro de `/bin` hay que crear un directorio llamado keymaps y ahí copiar los mapas de teclado se desee usar. Por ejemplo, para cambiar al mapa US hay que escribir `.keymap us` desde esxdos. También se puede cambiar con la utilidad `keymap`. Dentro de `/bin` hay que crear un directorio llamado `keymaps` y ahí copiar los mapas de teclado se desee usar. Por ejemplo, para cambiar al mapa US hay que escribir `.keymap us` desde esxdos.
Para que el mapa se conserve después de un master reset, hay que tener seleccionado `Default` en la configuración de BIOS. Para que el mapa se conserve después de un master reset, hay que tener seleccionado `Default` en la configuración de BIOS.
Para más información, consultar http://www.zxuno.com/forum/viewtopic.php?f=37&t=208[este mensaje en el foro]. Para más información, consultar http://www.zxuno.com/forum/viewtopic.php?f=37&t=208[este mensaje en el foro de ZX-Uno].
==== Español ==== Español
@ -276,17 +286,16 @@ El teclado de gomaDOS+ al ser similar al teclado del ZX Spectrum original, carec
Para cambiar entre los dos modos de teclado se utiliza la combinación de teclas `Caps Shift+Symbol Shift+F` y luego pulsar `D`. Para cambiar entre los dos modos de teclado se utiliza la combinación de teclas `Caps Shift+Symbol Shift+F` y luego pulsar `D`.
Durante la ejecución del core principal (ZX Spectrum): Teclas especiales que se pueden utilizar la ejecución del core principal (ZX Spectrum):
- `Esc`: BREAK - `Esc`: BREAK
- `F2` (`Caps Shift+Symbol Shift+2` en gomaDOS+, en modo completo): Edit - `F2` (`Caps Shift+Symbol Shift+2` en gomaDOS+, en modo completo): Edit
- `F5` (`NMI` en gomaDOS+): NMI - `F5` (`Caps Shift+Symbol Shift+5` en gomaDOS+, en modo completo - o bien `Caps Shift+Symbol Shift+F` y luego `Y` -): NMI
- `F7` (`Caps Shift+Symbol Shift+7` en gomaDOS+, en modo completo): Reproducir o Pausa en la reproducción de archivos .PZX - `F7` (`Caps Shift+Symbol Shift+7` en gomaDOS+, en modo completo): Reproducir o Pausa en la reproducción de archivos .PZX
- `F8` (`Caps Shift+Symbol Shift+8` en gomaDOS+, en modo completo): Rebobinar el archivo .PZX hasta la marca anterior - `F8` (`Caps Shift+Symbol Shift+8` en gomaDOS+, en modo completo): Rebobinar el archivo .PZX hasta la marca anterior
- `F10` (`Caps Shift+Symbol Shift+0` en gomaDOS+, en modo completo): Graph - `F10` (`Caps Shift+Symbol Shift+0` en gomaDOS+, en modo completo): Graph
- `F12` (`Caps Shift+Symbol Shift+W` en gomaDOS+, en modo completo): Turbo Boost. Pone a la CPU a 28MHz mientras se mantenga pulsada (a partir del core EXP27). - `F12` (`Caps Shift+Symbol Shift+W` en gomaDOS+, en modo completo): Turbo Boost. Pone a la CPU a 28MHz mientras se mantenga pulsada (a partir del core EXP27).
- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en gomaDOS+): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`.
- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en gomaDOS+): Hard reset. Backspace es la tecla de borrar hacia atrás, encima del enter.
- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en gomaDOS+): Soft reset. - `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en gomaDOS+): Soft reset.
- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): cambia de modo video compuesto a VGA y viceversa. - `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): cambia de modo video compuesto a VGA y viceversa.
@ -294,14 +303,18 @@ Durante el arranque:
- `F2` (`Caps Shift+1` en gomaDOS+, en modo completo) Entrar en la BIOS - `F2` (`Caps Shift+1` en gomaDOS+, en modo completo) Entrar en la BIOS
- `Bloq. Mayús` o `Cursor abajo` (`Caps Shift+2 en gomaDOS+): Menú de selección de cores - `Bloq. Mayús` o `Cursor abajo` (`Caps Shift+2 en gomaDOS+): Menú de selección de cores
- `Esc` (`Caps Shift+Espacio` en gomaDOS+): Menú de selección de roms del core de Spectrum - `Esc` (`Caps Shift+Espacio` en gomaDOS+): Menú de selección de ROMS del core de ZX Spectrum
- `R`: Carga la rom del core de Spectrum en modo «real» deshabilitando esxdos, nuevos modos gráficos, etc. - `R`: Carga la rom del core de ZX Spectrum en modo "real" deshabilitando esxdos, nuevos modos gráficos, etc.
- `/` (del teclado numérico) (`Symbol Shift+V` en gomaDOS+): Carga la rom del core de Spectrum en modo «root» - `/` (del teclado numérico) (`Symbol Shift+V` en gomaDOS+): Carga la rom del core de ZX Spectrum en modo "root"
- Número del `1` al `9`: Cargar el core en la ubicación de la Flash correspondiente a dicho número - Número del `1` al `9`: Cargar el core en la ubicación de la Flash correspondiente a dicho número
<<<
=== ROMs === ROMs
El core de ZX Spectrum tiene la capacidad de inicializar utilizando diferentes versiones de ROM. Estas se almacenan en la memoria flash del ZXDOS+, y se puede elegir cuál cargar, pulsando la tecla `Esc` durante el arranque. También es posible definir desde la configuración de BIOS, cuál es la ROM que se desea que se cargue por defecto. El core de ZX Spectrum tiene la capacidad de inicializar utilizando diferentes versiones de ROM (48K, 128K, Plus 2, etc.). Estas se almacenan en la memoria flash del ZXDOS+, y se puede elegir cuál cargar, pulsando la tecla `Esc` durante el arranque. También es posible definir desde la configuración de BIOS, cuál es la ROM que se desea que se cargue por defecto.
Véase el <<_roms_3,apartado de actualizaciones>> para más información sobre cómo ampliar o modificar las ROMs almacenadas en la memoria flash.
<<< <<<
@ -314,33 +327,33 @@ Existen dos tipos diferentes de comandos de esxdos, los llamados comandos "DOT",
Los principales comandos "DOT" commands son los siguientes: Los principales comandos "DOT" commands son los siguientes:
- `128`: Para pasar al modo 128K desde el modo 48K. - `128`: Para pasar al modo 128K desde el modo 48K.
- `cd`: Cambiar de directorio. - `cd`: Cambiar el directorio actual de trabajo.
- `chmod`: cambiar los atributos de los ficheros de la tarjeta SD. - `chmod`: cambiar los atributos de los ficheros de la tarjeta SD.
- `cp`: Copiar un archivo. - `cp`: Copiar un archivo.
- `divideo`: Reproduce un archivo de video DivIDEo (.DVO). - `divideo`: Reproduce un archivo de video DivIDEo (.DVO).
- `drives`: Mostrar las unidades - `drives`: Mostrar las unidades disponibles.
- `dskprobe`: Utilidad para ver el contenido a bajo nivel de un dispositivo de almacenamiento - `dskprobe`: Utilidad para ver el contenido a bajo nivel de un dispositivo de almacenamiento.
- `dumpmem`: Permite volcar contenido de la memoria RAM a un fichero - `dumpmem`: Permite volcar contenido de la memoria RAM a un fichero.
- `file`: Intenta determinar el tipo de un fichero por su contenido (como el comando de UNIX) - `file`: Intenta determinar el tipo de un fichero por su contenido (como el comando de UNIX).
- `gramon`: Monitor para buscar gráficos, sprites, fuentes de texto, etc. en la memoria RAM - `gramon`: Monitor para buscar gráficos, sprites, fuentes de texto, etc. en la memoria RAM.
- `hexdump`: Muestra el contenido de un fichero usando notacion hexadecimal - `hexdump`: Muestra el contenido de un fichero usando notación hexadecimal.
- `hexview`: Permite ver y navegar por el contenido de un fichero usando notacion hexadecimal - `hexview`: Permite ver y navegar por el contenido de un fichero usando notación hexadecimal.
- `launcher`: Crea un atajo (launcher) para abrir directamente un fichero TAP - `launcher`: Crea un atajo (launcher) para abrir directamente un fichero TAP.
- `ls`: Ver el contenido de un directorio. - `ls`: Ver el contenido de un directorio.
- `lstap`: Ver el contenido de un fichero .TAP - `lstap`: Ver el contenido de un fichero .TAP
- `mkdir`: Crear un directorio. - `mkdir`: Crear un directorio.
- `mktrd`: Crear un fichero imagen de disquete .TRD - `mktrd`: Crear un fichero imagen de disquete .TRD
- `more`: Ver el contenido de un archivo de texto - `more`: Ver el contenido de un archivo de texto.
- `mv`: Mover un archivo - `mv`: Mover un archivo.
- `partinfo`: Muestra información sobre las particiones de un dispositivo de almacenamiento - `partinfo`: Muestra información sobre las particiones de un dispositivo de almacenamiento.
- `playpt3`: Reproducir un archivo musical .PT3 - `playpt3`: Reproducir un archivo musical .PT3.
- `playsqt`: Reproducir un archivo musical .SQT - `playsqt`: Reproducir un archivo musical .SQT.
- `playstc`: Reproducir un archivo musical .STC - `playstc`: Reproducir un archivo musical .STC.
- `playtfm`: Reproducir un archivo musical .TFC - `playtfm`: Reproducir un archivo musical .TFC.
- `playwav`: Reproducir un archivo musical .WAV - `playwav`: Reproducir un archivo de audio .WAV.
- `rm`: Borrar un archivo o directorio - `rm`: Borrar un archivo o directorio.
- `snapload`: Carga ficheros snapshot - `snapload`: Carga ficheros snapshot.
- `speakcz`: Reproduces texto usando pronunciación checa - `speakcz`: Reproduces texto usando pronunciación checa.
- `tapein`: Montar un archivo .TAP para poder ser utilizado luego desde BASIC con la sentencia LOAD - `tapein`: Montar un archivo .TAP para poder ser utilizado luego desde BASIC con la sentencia LOAD
- `tapeout`: Montar un archivo .TAP para poder ser utilizado luego desde BASIC con la sentencia SAVE - `tapeout`: Montar un archivo .TAP para poder ser utilizado luego desde BASIC con la sentencia SAVE
- `vdisk`: Monta una unidad de disquete .TRD para usar en el entorno TR-DOS (Una vez montadas todas las unidades deseadas, se puede entrar en el emulador de TR-DOS escribiendo: `RANDOMIZE USR 15616`) - `vdisk`: Monta una unidad de disquete .TRD para usar en el entorno TR-DOS (Una vez montadas todas las unidades deseadas, se puede entrar en el emulador de TR-DOS escribiendo: `RANDOMIZE USR 15616`)
@ -349,8 +362,8 @@ Algunos comandos extendidos de BASIC son:
- `GO TO` para cambiar de unidad y/o directorio (ej: `GO TO hd1` o `GO TO hd0"juegos"`) - `GO TO` para cambiar de unidad y/o directorio (ej: `GO TO hd1` o `GO TO hd0"juegos"`)
- `CAT` para mostrar el contenido de una unidad - `CAT` para mostrar el contenido de una unidad
- `LOAD` para cargar un fichero desde una unidad (programa en BASIC, pantalla, código, etc.) - `LOAD` para cargar un fichero desde una unidad (programa en BASIC, pantalla, código, etc. por ejemplo `LOAD *"Pantalla.scr" SCREEN$`)
- `SAVE` para guardar datos en un fichero - `SAVE` para guardar datos en un fichero (Ej: `SAVE *"Programa.bas"`)
- `ERASE` para borrar un fichero - `ERASE` para borrar un fichero
Además, esxdos incluye un gestor NMI, es decir, una aplicación que se carga cuando se pulsa NMI (F5) y que facilita la navegación por la tarjeta microSD y la carga de algunos tipos de archivo (TAP, Z80, TRD, etc.). Pulsando la tecla "H" se accede a una pantalla de ayuda, en la que se indican todas las teclas disponibles. Además, esxdos incluye un gestor NMI, es decir, una aplicación que se carga cuando se pulsa NMI (F5) y que facilita la navegación por la tarjeta microSD y la carga de algunos tipos de archivo (TAP, Z80, TRD, etc.). Pulsando la tecla "H" se accede a una pantalla de ayuda, en la que se indican todas las teclas disponibles.
@ -361,37 +374,144 @@ Además, esxdos incluye un gestor NMI, es decir, una aplicación que se carga cu
Tal y como se ha explicado en la parte de instalación, existe una serie de comandos que son exclusivos para ZXDOS+, y que se describen a continuación: Tal y como se ha explicado en la parte de instalación, existe una serie de comandos que son exclusivos para ZXDOS+, y que se describen a continuación:
- `back32m`: Versión del comando backup exclusivo para memorias SPI Flash de 32 Megas. Tras terminar su ejecución hay que ejecutar el comando .ls para que se termine de grabar la cache en la tarjeta microSD, sino lo haces la longitud del archivo se quedará en 0 de forma errónea. - `back16m`: Copia a un fichero `FLASH.ZX1` en el directorio raíz de la tarjeta SD el contenido de una memoria SPI Flash de 16 Megas. Tras terminar su ejecución hay que ejecutar el comando `.ls` para que se termine de grabar la cache en la tarjeta.
- `core`: Carga el core del slot indicado (1 a 9). - `back32m`: Versión del comando backup exclusivo para memorias SPI Flash de 32 Megas. Tras terminar su ejecución hay que ejecutar el comando `.ls` para que se termine de grabar la cache en la tarjeta.microSD. Si no se hace, la longitud del archivo se quedará en 0 de forma errónea.
- `corebios`: Para hacer una actualización conjunta del core de ZX Spectrum y de la BIOS.
- `dmaplayw`: Reproduce un archivo de audio .WAV, que debe ser de 8 bits, sin signo y muestreado a 15625 Hz. - `dmaplayw`: Reproduce un archivo de audio .WAV, que debe ser de 8 bits, sin signo y muestreado a 15625 Hz.
- `joyconf`: Configura y prueba los joysticks keyboard y DB9. - `esprst`: Resetea el módulo WiFi ESP8266(ESP-12).
- `keymap`: Sirve para cargar una definición de teclado diferente - `iwconfig`: Configura el módulo WiFi.
- `loadpzx`: Para cargar un archivo de imagen de cinta .PZX - `joyconf`: Configura y prueba los joysticks de teclado y DB9.
- `playmid`: Reproduce archivos musicales .MID en el addon MIDI - `keymap`: Sirve para cargar una definición de teclado diferente.
- `playrmov`: Reproduce videos en formato radastaniano (ficheros .RDM) - `loadpzx`: Para cargar un archivo de imagen de cinta .PZX.
- `romsback`: Copia a un fichero ROMS.ZX1 en el directorio raíz de la tarjeta microSD todas las roms del core Spectrum almacenadas en la memoria SPI Flash - `playmid`: Reproduce archivos musicales .MID en el addon MIDI.
- `romsupgr`: Copia el contenido de un fichero ROMS.ZX1 en el directorio raíz de la tarjeta microSD con todas las roms para el core Spectrum a la memoria SPI Flash. - `playrmov`: Reproduce videos en <<#_creación_de_vídeos_rdm_radastan_movie,formato radastaniano (ficheros `.RDM`)>>. Este comando no funciona en modo 48K.
- `upgr32m`: Copia el contenido de un fichero FLASH.ZX2 en el directorio raíz de la tarjeta microSD a la memoria SPI Flash. - `romsback`: Copia a un fichero `ROMS.ZX1` en el directorio raíz de la tarjeta microSD todas las ROMS del core ZX Spectrum almacenadas en la memoria SPI Flash.
- `romsupgr`: Copia el contenido de un fichero `ROMS.ZX1` en el directorio raíz de la tarjeta microSD con todas las ROMS para el core ZX Spectrum a la memoria SPI Flash.
- `upgr16m`: Copia el contenido de un fichero `FLASH.ZX1` en el directorio raíz de la tarjeta SD a una memoria SPI Flash de 16 megas.
- `upgr32m`: Versión del comando upgrade exclusivo para memorias SPI Flash de 32 Megas.
- `zxuc`: Configura todas las opciones de la BIOS, permitiendo grabar en la microSD las opciones seleccionadas en archivos de configuración que pueden posteriormente ser cargados. - `zxuc`: Configura todas las opciones de la BIOS, permitiendo grabar en la microSD las opciones seleccionadas en archivos de configuración que pueden posteriormente ser cargados.
- `zxunocfg`: Configura determinados aspectos del funcionamiento del ZX-Uno como los timings, la contención, el tipo de teclado, la velocidad de la CPU, el tipo y frecuencia vertical del vídeo. - `zxunocfg`: Configura determinados aspectos del funcionamiento del ZX-Uno como los timings, la contención, el tipo de teclado, la velocidad de la CPU, el tipo y frecuencia vertical del vídeo.
<<<
=== Wi-Fi
Todos los gomaDOS+, y algunos modelos de ZXDOS+, tienen incorporado un módulo ESP-12 con un chip Wi-Fi https://es.wikipedia.org/wiki/ESP8266[ESP8266], que se puede utilizar fácilmente con un core de ZX Spectrum (por ejemplo, el core EXP27 160820) que tenga sintetizado un dispositivo https://es.wikipedia.org/wiki/Universal_Asynchronous_Receiver-Transmitter[UART], que permite la comunicacion con el módulo.
Para configurar de forma básica el acceso al módulo, existen dos comandos "DOT" que se pueden obtener desde https://github.com/zxdos/zxuno/tree/master/utils[el repositorio oficial en GitHub]:
- `esprst`, que sirve para reiniciar el módulo
- `iwconfig`, que se utiliza para indicar el identificador (SSID) y la contraseña de la red Wi-Fi a la que conectarse, que quedarán almacenados en el fichero `/sys/config/iw.cfg` para que puedan usarlos otros programas.
Por ejemplo:
[source,shell]
----
.iwconfig miwifi miclavedeacceso
----
==== Network tools for ZX-Uno pack
Se trata de un conjunto de programas, desarrollados por Nihirash y que se pueden https://nihirash.net/network-tools-for-zx-uno-pack/[descargar] https://nihirash.net/ugophy-1-0-and-nettools-for-zx-spectrum/#more-71[de su web].
- `netman`: Utilidad sencilla para configurar la conexión Wi-Fi para el resto de programas. No funciona en modo 48K.
- `uGophy`: Cliente de https://es.wikipedia.org/wiki/Gopher[Gopher]. No funciona en modo 48K.
- `irc`: Cliente de https://en.wikipedia.org/wiki/Internet_Relay_Chat[Internet Relay Chat]. Funciona mejor a 14 Mhz.
- `wget`: Utilidad para descargar ficheros vía HTTP (no funciona con HTTPS).
- `platoUNO`: Cliente de https://es.wikipedia.org/wiki/Programmed_Logic_Automated_Teaching_Operations[PLATO]. También funciona mejor a 14 Mhz. Para más información sobre el uso moderno de PLATO, es interesante la web de https://www.irata.online/#about[IRATA.ONLINE].
==== FTP-Uno
Cliente de FTP desarrollado por Yombo, disponible https://github.com/yomboprime/FTP_Uno[en GitHub].
Para utilizarlo, se deben seguir los siguientes pasos:
. Editar el archivo `FTP.CFG` con los datos necesarios (Wi-Fi, servidor FTP al que conectar, etc.)
. Copiar `FTP.CFG` en `/SYS/CONFIG/` en la tarjeta microSD
. Copiar también `ftpUno.tap` al lugar que desee de la tarjeta
. Iniciar el ZXDOS+ y cargar el archivo de cinta `ftpUno.tap`
<<<
==== UART Terminal
Se trata de un programa de ejemplo incluido con la biblioteca de funciones C https://github.com/yomboprime/ZXYLib[ZXYLib] desarrollada por yombo, y que permite enviar directamente pulsaciones de teclado a través del UART, y ver el resultado. Se puede descargar https://github.com/yomboprime/ZXYLib/raw/master/UARTTERM.tap[en este enlace].
Una vez copiado el fichero de cinta `UARTTERM.tap` y cargado, se pueden teclear distintos comandos específicos para el chip ESP8266. Por ejemplo:
- `AT`. Para verificar si hay comunicación con el chipo. El resultado normal, si todo está bien, sería `OK`
- `AT+RST`. Para reiniciar el chip. Es exactamente lo mismo que hace el comando <<#_wi_fi,`esprst`>>
- `AT+GMR`. Para ver información relativa al chip, versión de firmware instalado, etc
- `AT+CWMODE_CUR=1`. Para configurar el chip en modo cliente Wi-Fi de forma temporal, hasta el próximo reinicio
- `AT+CWMODE_DEF=1`. Para configurar el chip en modo cliente Wi-Fi y guardar el ajuste como opción por defecto
- `AT+CWJAP_CUR="<RedWiFi>","<ContraseñaWiFi>"`, donde `<RedWiFi>` es el ID de a red Wi-Fi donde conectar, y `<ContraseñaWiFi>` la contraseña de acceso, conecta temporalente a la red indicada
- `AT+CWJAP_DEF="<RedWiFi>","<ContraseñaWiFi>"`, conecta a la red indicada, y la guarda como red por defecto en la memoria del chip
- `AT+CWAUTOCONN=1` configura el chip para conectarse a la red Wi-Fi por defecto al encenderse (`AT+CWAUTOCONN=0` desactiva esta opción)
Se pueden consultar todos los comandos disponibles en https://www.espressif.com/sites/default/files/documentation/4a-esp8266_at_instruction_set_en.pdf[la documentación oficial del fabricante].
<<<
=== Creación de vídeos RDM (RaDastan Movie)
El comando `PLAYRMOV` reproduce videos en formato radastaniano. Para poder convertir nuestros propios vídeos, se debe obtener la utilidad `makevideoradas` desde el http://svn.zxuno.com/svn/zxuno/software/modo_radastan/videos_radastanianos/[Repositorio SVN].
En el caso de Windows, en el propio repositorio hay un ejecutable (`makevideoras.exe`) ya preparado. Para Linux o MacOS, será necesario tener las herramientas de desarrollo correspondientes y compilarlo.
[source,shell]
----
gcc makevideoradas.c -o makevideoradas
----
Una vez dispongamos de `makevideoradas`, necesitaremos otras dos herramientas: https://ffmpeg.org[`ffmpeg`] e https://imagemagick.org/index.php[`imagemagick`]. Estas se pueden instalar con el gestor de paquetes corespondiente (`apt`, `yum`, `pacmam`, `brew`, etc.) o descargando el código fuente y compilándolo también.
Ahora, el primer paso para convertir nuestro vídeo (por ejemplo, `mivideo.mp4`), es exportar los fotogramas como imágenes BMP de 128x96 píxeles de tamaño. Crearemos un directorio temporal (`img` en este ejemplo), donde guardar dichas imágenes.
[source,shell]
----
mkdir img
(...)/ffmpeg -i mivideo.mp4 -vf "scale=128:96,fps=25" -sws_flags lanczos -sws_dither ed -pix_fmt rgb4 -start_number 0 img/output%05d.bmp
----
Ahora transformaremos los ficheros `BMP` a `BMP` (v3) de 16 colores.
[source,shell]
----
(...)/magick mogrify -colors 16 -format bmp -define bmp:format=bmp3 img/*.bmp
----
Finalmente, creamos el fichero `.RDM` (en este ejemplo `mivideo.rdm`) y borramos las imágenes y el directorio temporal.
[source,shell]
----
(...)/makevideoradas img/output
mv img/output.rdm ../mivideo.rdm
rm -rf img
----
En https://www.zonadepruebas.com/viewtopic.php?t=4796&start=110[este hilo del foro Zona de Pruebas] hay más información sobre todo este proceso.
<<<
== Actualizaciones == Actualizaciones
=== BIOS === BIOS
Para actualizar BIOS se ha de obtener un fichero del tipo `FIRMWARE.ZX2` (para un ZXDOS+ con placa FPGA LX16) o `FIRMWARE.ZXD` (para un ZXDOS+ con placa FPGA LX25). La última versión de los ficheros de firmware se puede obtener desde https://github.com/zxdos/zxuno/tree/master/firmware[el repositorio oficial] Para actualizar BIOS se ha de obtener un fichero llamado `FIRMWARE.ZX2` (para un ZXDOS+ con placa FPGA LX16) o `FIRMWARE.ZXD` (para un ZXDOS+ con placa FPGA LX25). La última versión de los ficheros de firmware se puede descargar desde https://github.com/zxdos/zxuno/tree/master/firmware[el repositorio oficial]
Nota: actualizar el firmware (BIOS) es delicado, no se debe hacer si no es necesario. En el caso de hacerlo, procurar que el ZXDOS+ tenga alimentación ininterumpida (como un SAI o un USB de portatil con batería). [WARNING]
====
Actualizar el firmware (BIOS) es delicado, no se debe hacer si no es necesario. En el caso de hacerlo, procurar que el ZXDOS+ tenga alimentación ininterumpida (como un SAI o un USB de portatil con batería).
====
Copiar el fichero en la raíz de la tarjeta MicroSD, encender y pulsar F2 para entrar en la BIOS, seleccionar `Upgrade`, elegir «Upgrade BIOS for ZX», y luego «SDfile». El sistema leerá el fichero `FIRMWARE...` y avisará cuando esté actualizado. Copiar el fichero en la raíz de la tarjeta MicroSD, encender y pulsar `F2` para entrar en la BIOS, seleccionar `Upgrade`, elegir __"Upgrade BIOS for ZX"__, y luego __"SDfile"__. El sistema leerá el fichero `FIRMWARE...` y avisará cuando esté actualizado.
=== ROMs === ROMs
Para actualizar las ROM instaladas para ZX Spectrum se ha de obtener un fichero del tipo `ROMS.ZX1`, que se tiene que copiar en la tarjeta MicroSD. Arrancar el ZX-Uno usando una ROM «rooted». Entonces basta con introducir el comando `.romsupgr`. Esto grabará todas las ROM, que quedarán disponibles para su uso. Para actualizar las ROM instaladas para ZX Spectrum se ha de obtener un fichero con el nombre `ROMS.ZX1`, y se tiene que copiar en la tarjeta MicroSD. Arrancar el ZXDOS+ usando una ROM "rooted", y entonces bastará con introducir el comando `.romsupgr`. Esto grabará todas las ROM, que quedarán disponibles para su uso.
[NOTE] [NOTE]
==== ====
Recordar que, si se inicia el ZXDOS+ pulsando la tecla `/` (del teclado numérico) (`Symbol Shift+V` en gomaDOS+), entonces se cargará la ROM por defecto del core de Spectrum en modo «root». Recordar que, si se inicia el ZXDOS+ pulsando la tecla `/` (del teclado numérico) (`Symbol Shift+V` en gomaDOS+), entonces se cargará la ROM por defecto del core de ZX Spectrum en modo "root".
==== ====
Para hacer el proceso contrario (guardar las ROM en un fichero `ROMS.ZX1`), se puede usar el comando `.romsback`. Para hacer el proceso contrario (guardar las ROM en un fichero `ROMS.ZX1`), se puede usar el comando `.romsback`.
@ -400,7 +520,9 @@ Los ficheros `ROMS.ZX1` se pueden editar fácilmente con la utilidad http://gues
=== Cores === Cores
Hay xx slots para cores disponibles (depende del tamaño de la SPI Flash del modelo de ZXDOS), estando reservado el primer slot para el de Spectrum. Hay un número de slots disponibles para almacenar cores (el número depende del tamaño de la SPI Flash del modelo de ZXDOS), estando reservado el primer slot para el de ZX Spectrum principal (esto no impide tener más cores de ZX Spectrum en otros slot además del primero).
Los cores oficiales están https://github.com/zxdos/zxdos-plus/tree/master/cores[disponibles para descargar] en el repositorio en GitHub.
Para actualizar o instalar un nuevo core hay varias alternativas. Para actualizar o instalar un nuevo core hay varias alternativas.
@ -411,11 +533,11 @@ La forma más sencilla consiste en obtener la última versión del fichero que l
A partir de la version 0.80 de BIOS, los ficheros se nombran usando la convención `COREXXy.ZXn` donde XX _siempre_ es un número de dos digitos. Así, un antiguo fichero `CORE4.ZXD` ha de renombrarse como `CORE04.ZXD`. La parte `y` del nombre se ignora, así que se pueden usar nombres más largos y descriptivos (como, por ejemplo, `CORE04_ejemplo.ZXD`). A partir de la version 0.80 de BIOS, los ficheros se nombran usando la convención `COREXXy.ZXn` donde XX _siempre_ es un número de dos digitos. Así, un antiguo fichero `CORE4.ZXD` ha de renombrarse como `CORE04.ZXD`. La parte `y` del nombre se ignora, así que se pueden usar nombres más largos y descriptivos (como, por ejemplo, `CORE04_ejemplo.ZXD`).
==== ====
Copiar el fichero en la raíz de la tarjeta microSD, encender y pulsar F2 para entrar en la BIOS. Elegir `Upgrade`, seleccionar la fila correspondiente al número de core elegido (por ejemplo, la 2 justo después de la de Spectrum), pulsar enter y luego «SD file». El sistema leerá el fichero `COREnn...` y avisará cuando esté actualizado, aunque antes preguntará el nombre (con el que se verá en la lista para elegir el arranque y en el listado de la BIOS). Una vez instalado, se podrá acceder a él al arrancar. Copiar el fichero en la raíz de la tarjeta microSD, encender y pulsar `F2` para entrar en la BIOS. Elegir `Upgrade`, seleccionar la fila correspondiente al número de core elegido (por ejemplo, la 2 justo después de la de Spectrum), pulsar enter y luego __"SD file"__. El sistema leerá el fichero `COREnn...` y avisará cuando esté actualizado, aunque antes preguntará el nombre (con el que se verá en la lista para elegir en el arranque y en el listado de la BIOS). Una vez instalado, se podrá utilizar al arrancar.
[WARNING] [WARNING]
==== ====
La actualización del core de Spectrum es exactamente igual que los otros cores, pero en lugar del fichero `CORE1.ZX2` o `CORE1.ZXD`, ha de ser un fichero llamado `SPECTRUM.ZX2` o `SPECTRUM.ZXD`. La actualización del core de ZX Spectrum es exactamente igual que los otros cores, pero en lugar del fichero `CORE1.ZX2` o `CORE1.ZXD`, ha de ser un fichero llamado `SPECTRUM.ZX2` o `SPECTRUM.ZXD`.
==== ====
=== esxdos === esxdos
@ -424,9 +546,9 @@ 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+). 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` 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...` y avisará cuando esté actualizado. 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.
Realizar un Hard-reset, o apagar y encender. Realizar un Hard-reset, o apagar y encender.
@ -445,10 +567,8 @@ Principalmente gracias a avlixa, existe una versión del core de ZX Spectrum Nex
El core para ZXDOS+ no tiene, por el momento, implementada ninguna de las siguientes caracteristicas: El core para ZXDOS+ no tiene, por el momento, implementada ninguna de las siguientes caracteristicas:
- Raspberry Pi - Raspberry Pi
- Módulo ESP
- Beeper interno - Beeper interno
- Conector de expansión EDGE - Conector de expansión EDGE
- Memoria superior a 1Mb
- Módulo RTC - Módulo RTC
- Teclado de membrana - Teclado de membrana
- Flasheo de cores adicionales o actualización del propio core Next desde el core Next - Flasheo de cores adicionales o actualización del propio core Next desde el core Next
@ -466,7 +586,7 @@ Se debe de utilizar una tarjeta microSD con la primera partición en formato FAT
Obtener la distribución de NextZXOS https://www.specnext.com/latestdistro/[en la página oficial]. Obtener la distribución de NextZXOS https://www.specnext.com/latestdistro/[en la página oficial].
Descomprimir el contenido en la tarjeta microSD, pero modificando el archivo `config.ini` en `/machines/next` para que contenga (si no existiera ya) la línea `ps2=0` (para asegurar que se utiliza correctamente el puerto del teclado) y la línea `intbeep=0` para apagar el zumbador interno. Descomprimir el contenido de NextZXOS en la tarjeta microSD, pero modificando el archivo `config.ini` en `/machines/next` para que contenga (si no existiera ya) la línea `ps2=0` (para asegurar que se utiliza correctamente el puerto del teclado) y la línea `intbeep=0` para apagar el zumbador interno (este último paso no es necesario en el caso de un gomaDOS+).
Si no estuviera ya, <<_cores,instalar el core de ZX Spectrum Next>> en el ZXDOS+. Si no estuviera ya, <<_cores,instalar el core de ZX Spectrum Next>> en el ZXDOS+.
@ -504,7 +624,7 @@ image::img/next2.png[pdfwidth=70%]
<<< <<<
Si se elige `Browser`, se cargará el navegador de NextZXOS, desde el que es posible desplazarse viendo el contenido de la tarjeta microSD y cargar directamente diferentes tipos de archivo (TAP, NEX, DSK, SNA, SNX, Z80,, Z8, etc.). Si se elige `Browser`, se cargará el navegador de NextZXOS, desde el que es posible desplazarse viendo el contenido de la tarjeta microSD y cargar directamente diferentes tipos de archivo (TAP, NEX, DSK, SNA, SNX, Z80, Z8, etc.).
[.text-center] [.text-center]
image::img/next3.png[pdfwidth=70%] image::img/next3.png[pdfwidth=70%]
@ -575,7 +695,7 @@ Si no estuviera ya, <<_cores,instalar el core de MSX>> en el ZXDOS+.
Durante la ejecución del core: Durante la ejecución del core:
- `Impr Pant`: Cambia el modo VGA - `Impr Pant`: Cambia el modo entre VGA y RGB
- `Bloq Desp`: Cambia el modo de línea de exploración (Scanlines) - `Bloq Desp`: Cambia el modo de línea de exploración (Scanlines)
- `Pausa`: Cambia entre 50Hz y 60Hz - `Pausa`: Cambia entre 50Hz y 60Hz
- `F11`: Activa o desactiva el modo turbo - `F11`: Activa o desactiva el modo turbo
@ -635,7 +755,7 @@ MSXCTRL -h -i -r -b -[5|6] -m<0-2>
Existen múltiples sistemas para cargar los juegos dependiendo del tipo de archivo: .CAS, .DSK o ROM (ver http://www.zxuno.com/forum/viewtopic.php?f=53&t=2080[este hilo del foro de ZX-Uno] para más información). Existen múltiples sistemas para cargar los juegos dependiendo del tipo de archivo: .CAS, .DSK o ROM (ver http://www.zxuno.com/forum/viewtopic.php?f=53&t=2080[este hilo del foro de ZX-Uno] para más información).
El mapeo de para teclado español disponible con la distribución oficial se puede cambiar por otro más completo ver http://www.zxuno.com/forum/viewtopic.php?f=53&t=2897[aquí] para más información. El mapeo de para teclado español disponible con la distribución oficial se puede cambiar por otro más completo. Ver http://www.zxuno.com/forum/viewtopic.php?f=53&t=2897[aquí] para más información.
<<< <<<
@ -669,7 +789,7 @@ Copiar tanto los ficheros `ROM` como los `DSK` a la raíz de la partición FAT32
Durante la ejecución del core: Durante la ejecución del core:
- `Re Pág`: Hace un Reset del Amstrad y carga el siguiente archivo `DSK` en orden alfabético. - `Re Pág`: Hace un Reset del Amstrad y carga el siguiente archivo `DSK` en orden alfabético.
- Sólo funciona la tecla mayúsculas del lado izquierdo del teclado - Sólo funciona la tecla mayúsculas del lado izquierdo del teclado.
<<< <<<
@ -699,7 +819,36 @@ Se debe de utilizar una tarjeta microSD con la primera partición en formato FAT
Descargar la última versión de Atom Software Archive https://github.com/hoglet67/AtomSoftwareArchive/releases/latest[desde GitHub]. Descargar la última versión de Atom Software Archive https://github.com/hoglet67/AtomSoftwareArchive/releases/latest[desde GitHub].
Descomprimir todo el contenido del archivo en la raíz de la tarjeta. El contenido del directorio `SYS` es compatible con el directorio `SYS` de esxdos, siendo posible combinar los dos en uno solo. Ahora, se puede organizar la información en la tarjeta microSD de dos maneras distintas:
. Descomprimir todo el contenido del archivo en la raíz de la tarjeta. El contenido del directorio `SYS` es compatible con el directorio `SYS` de esxdos, siendo posible combinar los dos en uno solo.
. Organizar la información de una manera más reducida en la raíz, utilizando sólo dos directorios. Crear un directorio `ATOM` en la raíz de la tarjeta, y copiar en su interior todo el contenido del archivo, excepto el directorio `MANPAGES` que se tendrá que poner también en la raíz de la microSD. Luego, copiar los ficheros del archivo `trick_ATOM_folder` (disponible http://www.zxuno.com/forum/viewtopic.php?f=16&t=4006[en el foro de ZX-Uno]), reemplazando todos los que se encuentren con el mismo nombre. Así, quedará una estructura como la siguiente:
----
/
+-ATOM/
| +-AA/
| (...)
| +-AGD/
| | +-SHOW2
| | +-SHOW3
| (...)
| +-MENU
| (...)
| +-TUBE/
| | +-BOOT6502
| (..)
|
+-MANPAGES/
| +-CPM.MAN
| +-FLEX.MAN
| (...)
|
+-MENU
----
<<<
==== Teclado ==== Teclado
@ -714,7 +863,10 @@ Durante la ejecución del core:
- `F3`: Modo turbo 4Mhz - `F3`: Modo turbo 4Mhz
- `F4`: Modo turbo 8Mhz - `F4`: Modo turbo 8Mhz
El teclado está mapeado en inglés. El teclado está mapeado en inglés, según el siguiente esquema:
[.text-center]
image::img/keyboardAtom.jpg[pdfwidth=90%]
<<< <<<
@ -833,12 +985,12 @@ Este core no utiliza la tarjeta microSD.
Durante la ejecución del core: Durante la ejecución del core:
- `Esc` o botón 2 del joystick (o `Caps Shift+Espacio` en gomaDOS+): Mostrar u ocultar el menú de configuración - `Esc` o botón 2 del joystick (o `Caps Shift+Espacio` en gomaDOS+): Mostrar u ocultar el menú de configuración
- `Ctrl+Alt+Backspace` (CS+SS+F y G): Hard reset. Backspace es la tecla de borrar hacia atrás, encima del enter - `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+F` y `G`): Hard reset. Backspace es la tecla de borrar hacia atrás, encima del enter
- `Bloq. Despl.`: cambia de modo video compuesto a VGA y viceversa - `Bloq. Despl.`: cambia de modo video compuesto a VGA y viceversa
- `F3` o `F12`: Reinicio del juego - `F3` o `F12`: Reinicio del juego
- Número del `1` al `7`: Cambiar el tipo de juego - Número del `1` al `7`: Cambiar el tipo de juego
- `Cursor arriba` y `Cursor abajo`: Control de paleta de la izquierda (Jugador 1 en modo 2 jugadores y jugador 3 en modo de 4 jugadores) - `Cursor arriba` y `Cursor abajo`: Control de paleta de la izquierda (Jugador 1 en modo 2 jugadores y jugador 3 en modo de 4 jugadores)
- Joystick 1: Control de paleta de la derecha (Jugador 1) - Joystick 1: Control de paleta de la izquierda (Jugador 1)
- `Q` y `A`: Control de paleta de la derecha (Jugador 2 en modo 2 jugadores y jugador 4 en modo de 4 jugadores) - `Q` y `A`: Control de paleta de la derecha (Jugador 2 en modo 2 jugadores y jugador 4 en modo de 4 jugadores)
- Joystick 2: Control de paleta de la derecha (Jugador 2). - Joystick 2: Control de paleta de la derecha (Jugador 2).
- `Z`, `M` o botón de joystick 1: Saque manual - `Z`, `M` o botón de joystick 1: Saque manual
@ -863,6 +1015,59 @@ En él se pueden activar o desactivar las siguientes opciones:
- Duplicar el tamaño del menún (Double OSD Window) - Duplicar el tamaño del menún (Double OSD Window)
- Salir del menú (Exit) - Salir del menú (Exit)
<<<
=== NES
Nintendo Entertainment System (también conocida como Nintendo NES o simplemente NES) es la https://es.wikipedia.org/wiki/Nintendo_Entertainment_System[segunda consola de sobremesa de Nintendo].
La versión para ZXDOS+ ha sido creada por Nihirash, basándose en la http://www.zxuno.com/forum/viewtopic.php?t=1245[anterior para ZX-Uno] de DistWave y Quest.
Algunas de las características del core son:
- Filtro HQ2X que "despixeliza" la imagen
- Simulación de línea de exploración (Scanlines)
- Utiliza el reloj de la NES NTSC, por tanto funcionan correctamente las ROMs USA. Las ROMs PAL van más rápido de lo que deberían
- Permite cargar ROMS desde la SD
- Necesita, al menos, un mando o joystick conectado y que tenga varios botones de disparo
- Sólo soporta salida VGA y utiliza timings poco rigurosos, por lo que es posible que de problemas en algunos monitores
==== 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 (extensión `.NES`) de los juegos que se desee cargar. Los ficheros pueden estar en subdirectorios.
Si no estuviera ya, <<_cores,instalar el core de NES>> en el ZXDOS+.
==== Teclado
==== Teclas especiales y botones
Durante la ejecución del core:
- `Esc` o botón 2 del joystick (o `Caps Shift+Espacio` en gomaDOS+): Mostrar u ocultar el menú de configuración
- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+F` y `G`): Hard reset. Backspace es la tecla de borrar hacia atrás, encima del enter
<<<
==== Guía básica
Pulsando `Esc` se muestra el menú de configuración. Para desplazarse por el menú y activar o elegir alguna opción, se utilizan las teclas de cursor y `Enter`.
[.text-center]
image::img/nes.jpg[pdfwidth=70%]
En él se pueden activar o desactivar las siguientes opciones:
- Reiniciar la NES (Reset NES)
- Activar o desactivar línea de exploración (Scanlines)
- Encender o apagar el filtro que suaviza la imagen (HQ2X Filter)
- Simular la pulsación del botón Select del mando 1 (P1 Select)
- Simular la pulsación del botón Start del mando 1 (P1 Start)
- Elegir un ROM para cargar desde la SD (Load ROM)
- Salir del menú (Exit)
<<<
== Solución de problemas == Solución de problemas
=== Recuperación del firmware === Recuperación del firmware
@ -1041,8 +1246,22 @@ http://www.zxuno.com/wiki/index.php/ZX_Spectrum[Core ZX Spectrum]
http://www.zxuno.com/forum/viewtopic.php?f=37&t=208[Layouts de teclado] http://www.zxuno.com/forum/viewtopic.php?f=37&t=208[Layouts de teclado]
https://github.com/ManuFerHi/ZX-GO-/blob/master/ZXUNOPS2/Nuevo%20firmware%20de%20teclado%20ZX-GO%2B%20V30052019.pdf[Nuevo firmware de teclado ZX-GO+]
https://docs.google.com/spreadsheets/d/17-ifpHcy932_AP7SAv9uBLxg-2ZptcdgTvQ8ILXQLM4/htmlview[Almost (In-) Complete List of esxDOS DOT-Commands] https://docs.google.com/spreadsheets/d/17-ifpHcy932_AP7SAv9uBLxg-2ZptcdgTvQ8ILXQLM4/htmlview[Almost (In-) Complete List of esxDOS DOT-Commands]
http://retrowiki.es/viewtopic.php?f=83&t=200032578&p=200075671&hilit=wifi#p200075671[WiFi (RetroWiki)]
http://www.zxuno.com/forum/viewtopic.php?f=35&t=44[WiFi en ZX-Uno]
http://svn.zxuno.com/svn/zxuno/cores/spectrum_v2_spartan6/test19_multi_uart/[Core de ZX-Uno Test UART (WiFi)]
https://nihirash.net/network-tools-for-zx-uno-pack/[Network tools for ZX-Uno pack]
https://www.espressif.com/sites/default/files/documentation/4a-esp8266_at_instruction_set_en.pdf[ESP8266 AT Instruction Set]
https://www.zonadepruebas.com/viewtopic.php?t=4796&start=110[Vídeos Radastanianos]
http://www.forofpga.es/viewtopic.php?t=349[Core ZXNEXT en ZXDOS] http://www.forofpga.es/viewtopic.php?t=349[Core ZXNEXT en ZXDOS]
https://gitlab.com/thesmog358/tbblue/-/blob/master/docs/zxdos/zxdoscoreinstall.txt[ZX Spectrum Next en ZXDOS] https://gitlab.com/thesmog358/tbblue/-/blob/master/docs/zxdos/zxdoscoreinstall.txt[ZX Spectrum Next en ZXDOS]
@ -1059,6 +1278,10 @@ https://www.konamiman.com/msx/nextor/docs/Nextor%202.0%20User%20Manual.pdf[Nexto
https://konamiman.github.io/MSX2-Technical-Handbook/md/Chapter3.html[MSX-DOS] https://konamiman.github.io/MSX2-Technical-Handbook/md/Chapter3.html[MSX-DOS]
http://www.zxuno.com/forum/viewtopic.php?f=16&t=4006[Atom Software Archive en carpeta ATOM]
http://www.zxuno.com/forum/viewtopic.php?f=16&t=4005[Teclado Core Atom]
https://catleytech.com/?p=2679[Programming a Spartan 6 with a Raspberry Pi] 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] http://www.zxuno.com/forum/viewtopic.php?f=25&t=375[Tutorial para desbriquear el ZX-Uno con una Raspberry]

File diff suppressed because one or more lines are too long

Binary file not shown.

Before

Width:  |  Height:  |  Size: 108 KiB

After

Width:  |  Height:  |  Size: 107 KiB

BIN
doc/img/keyboardAtom.jpg Executable file

Binary file not shown.

After

Width:  |  Height:  |  Size: 316 KiB

BIN
doc/img/nes.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 190 KiB