Manual 0.5 (pre-release) de ZXUNO+

Añadidos cores de Commodore PET, VIC-20 y Jupiter ACE

doc/English ZXUNO+ Manual.adoc

@@ -1,6 +1,6 @@
 = ZXUNO+ Manual
 :author: kounch
-:revnumber: 0.4
+:revnumber: 0.5
 :doctype: book
 :front-cover-image: image:img/portadauno.jpg[]
 :email: kounch@users.noreply.github.com
@@ -683,7 +683,7 @@ https://www.facebook.com/groups/DerbyPro[DerbyPro or Derby{pp}] is an enhanced f
 
 You can download the ROM, a user manual and other files from the https://www.facebook.com/groups/DerbyPro[official Facebook Public Group].
 
-Since it is a 64K ROM with support for new hardware, these flags can be used when <<#_zx123_tool,adding it to the SPI flash>>:
+This 64K ROM has support for new hardware, including the use of esxdos commands from 128 BASIC, so these flags can be used when <<#_zx123_tool,adding it to the SPI flash>>:
 
 [%header,cols=2*] 
 |===
@@ -791,6 +791,7 @@ While it shares a common code base with many versions of Sinclair BASIC (the TS1
 - Terminal character entry (CTRL, META).
 - Keyboard buffer.
 - Full sized keyboard support.
+- Designed to take full advantage of the additional features of ZX-Uno Spectrum core
 
 The main differences from Microsoft BASIC are:
 
@@ -972,11 +973,6 @@ You can add a new ROM pressing the key `N` at the BIOS <<#_roms,ROMs screen>>, c
 
 To update at once all the ROMs installed for ZX Spectrum, a RomPack file named `ROMS.ZX1` must be obtained, which must be copied to the SD card. Boot the ZXUNO+ using a "rooted" ROM, and then just enter the command `.romsupgr`. This will burn all the ROMs, which will be available for use.
 
-[WARNING]
-====
-At this moment, `romsupgr`, only works correctly with RomPack files using a maximum of 35 slots.
-====
-
 [NOTE]
 ====
 Remember that if the ZXUNO+ is started by pressing the `/` key, then the default ROM of the ZX Spectrum core will be loaded in" root "mode.
@@ -984,11 +980,6 @@ Remember that if the ZXUNO+ is started by pressing the `/` key, then the default
 
 To do the opposite process (save the ROMs in a RomPack file named `ROMS.ZX1`), you can use the` .romsback` command.
 
-[WARNING]
-====
-At this moment, `romsback`, only stores correctly the first 35 used slots.
-====
-
 RomPack files can be easily edited with the https://guest:zxuno@svn.zxuno.com/svn/zxuno/software/ZX1RomPack/[ZX1RomPack] utility. Although it is a Windows program, it works perfectly, for example using https://www.winehq.org[Wine] or similar programs, either on MacOS or Linux.
 
 === Cores
@@ -1835,6 +1826,150 @@ Now, to load a specific file, use the command `LOAD "<name>",8` (where `<name>`
 
 <<<
 
+=== Commodore PET
+
+The https://es.wikipedia.org/wiki/Commodore_PET[Commodore PET (Personal Electronic Transactor)] was a line of personal computers produced starting in 1977 by Commodore International. 
+
+The ZX-Uno version has been https://www.zxuno.com/forum/viewtopic.php?f=50&t=683&start=20[made by Jepalza], based on the https://www.skibo.net/projects/pet2001fpga/[pet2001fpga] project.
+
+Features:
+
+- Tape loading using the audio input
+- Only works on VGA
+
+==== SD card format
+
+This core does not use the SD card
+
+==== Keyboard
+
+===== Special keys and buttons
+
+While running the core:
+
+- `F1`: Cancel tape loading
+- `Alt`: Type using graphic mode
+
+==== Basic Guide
+
+You can load from a external tape (or other external audio device) with the command `LOAD`. One it's finished, type `RUN` and press `ENTER` if needed. 
+
+[NOTE]
+====
+Maxduino, which is used in <<<<#_miniduino,miniduino>> does not, at this moment, support for Commodore PET tape files.
+====
+
+[TIP]
+====
+You can use programs like <<#_audio_file_conversion,Audiotap>> with Commodore `TAP` files.
+====
+
+<<<
+
+=== Commodore VIC-20
+
+The https://en.wikipedia.org/wiki/Commodore_VIC-20[Commodore VIC-20] (VC-20 in Germany and VIC-1001 in Japan) was an 8-bit home computer sold by Commodore Business Machines. The VIC-20 was announced in 1980, roughly three years after the Commodore PET. 
+
+The ZX-Uno version has been made by McLeod and Quest
+
+Main features:
+
+- 32K RAM expansion. It can be disabled for greater compatibility
+- Tape loading using the audio input
+- Audio input signal polarity change support
+- Composite video and VGA support
+- Joystick support
+
+==== SD card format
+
+This core does not use the SD card
+
+==== Keyboard
+
+===== Special keys and buttons
+
+While the core is running:
+
+- `F9` to `F11`: Load cartridges embedded in the core
+- Numeric keyboard `-`: Change audio input polarity. The red LED is enable when inverted.
+- `Scroll Lock`: To switch between composite video and VGA
+- `F11`: Swtich the joystick mapping between port 0 or port 1
+- `Num Lock`: Reset disabling the 32K memory expansion (enabled by default)
+- `F12`: Reset enabling the memory expansion
+- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`
+
+==== Basic Guide
+
+You can load from a external tape (or other external audio device) with the command `LOAD`. One it's finished, type `RUN` and press `ENTER` if needed. 
+
+[NOTE]
+====
+Maxduino, which is used in <<#_miniduino,miniduino>> does not, at this moment, support for Commodore VIC-20 tape files.
+====
+
+[TIP]
+====
+You can use programs like <<#_audio_file_conversion,Audiotap>> with Commodore `TAP` files.
+====
+
+<<<
+
+=== Jupiter ACE
+
+The https://en.wikipedia.org/wiki/Jupiter_Ace[Jupiter ACE]  was a british micro computer produced by Jupiter Cantab in the early 1980s.
+
+The ZX-Uno core has been developed by McLeod and enhanced by Azesmbog, and has, amongst others, the following features:
+
+- Tape loading using the audio input
+- Tape loading from the SD card (with https://zx-pk.ru/threads/29892-sd-karta-i-sdos-dlya-8i-bitnykh-pk.html[SDOS])
+
+==== SD card format
+
+You can use a SD card with the first partition in FAT16 format, where you can store Jupiter ACE `.TAP` files, which you can get, for exampel at the https://www.jupiter-ace.co.uk/index.html[Jupiter ACE Archive] website.
+
+==== Keyboard
+
+===== Special keys and buttons
+
+While the core is running:
+
+- `F1` ti `F4`: Turbo Modes
+- `F12`: Soft Reset
+- `Ctrl+Alt+Supr`: Reset
+- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`
+
+==== Basic Guide
+
+From within BASIC, you can load from a external tape (or <<#_miniduino,other external audio device>>) with the comand `LOAD <nombre>`.
+
+[CAUTION]
+====
+Jupiter ACE `TAP` files are different from the ZX Spectrum ones, so, to use then with a miniduino, they have to be converted previously to `TZX` with the `acetap2zx` utility available at https://guest:zxuno@svn.zxuno.com/svn/zxuno/software/jupiter_ace/utils[ZX-Uno repository] (User `guest`, password `zxuno`).
+====
+
+To load tape files from the SD card, you have to acces first to SDOS typing
+
+[source]
+----
+61440 call
+----
+
+After that, with instructions like `CD` and `DIR` you can access where the `TAP` file to load is located. Then, to load a `.TAP` file, you only have to type the name, without extension (for example, for a file named `GAME.TAP` you have to type `GAME`).
+
+[TIP]
+====
+All SDOS commands have to be typed in uppercase.
+====
+
+Once the tape has finished loading, type the corresponding command to start the program.
+
+[NOTE]
+====
+Instead of BASIC like other systems, Jupiter ACE uses https://en.wikipedia.org/wiki/Forth[Forth]. To see the commands currently available (including those that will start a program loaded from tape, you have to type `vlist`.
+====
+
+<<<
+
 === MSX
 
 MSX1FPGA is a project to clone MSX1 in FPGA. The original development is by Fabio Belavenuto and is available https://github.com/fbelavenuto/msx1fpga[at GitHub].
@@ -2056,7 +2191,7 @@ See the <<#_cores,corresponding section>> for instructions of how to install the
 
 The https://en.wikipedia.org/wiki/ZX81[ZX81] was a home computer produced by Sinclair Research,designed to be a low-cost introduction to home computing for the general public.
 
-The ZXUNO+ version has been https://www.zxuno.com/forum/viewtopic.php?f=54&t=703[made by jepalza] based on http://zxgate.sourceforge.net/[a previos ZX97 implementation].
+The ZXUNO+ version has been https://www.zxuno.com/forum/viewtopic.php?f=54&t=703[made by Jepalza] based on http://zxgate.sourceforge.net/[a previous ZX97 implementation].
 
 ==== SD card format
 
@@ -2154,7 +2289,7 @@ In these cases, it's recommended (if possible) to disable headphone volume limit
 
 These are some of the many programas that exist and which can export tape files to audio files.
 
-https://www.alessandrogrussu.it/tapir/index.html[Tapir] is a GUI program for Windows (but which can also run with Wine on Linux or Mac) that can load `TZX` and `TAP` files and export to `WAV` audio
+https://www.alessandrogrussu.it/tapir/index.html[Tapir] is a GUI program for Windows (but which can also run with Wine on Linux or Mac) that can load `TZX` and `TAP` files and export to `WAV` audio.
 
 `tape2wav` from https://fuse-emulator.sourceforge.net/[Fuse Utilities] is a command line utility that can export from `TZX` `PZX` and `TAP` to `WAV`.
 
@@ -2162,6 +2297,8 @@ https://www.alessandrogrussu.it/tapir/index.html[Tapir] is a GUI program for Win
 
 `tsx2wav` in https://github.com/nataliapc/MSX_devs/tree/master/TSXphpclass[TSXphpclass] is made with PHP and that can export from `TSX` to `WAV`.
 
+https://sourceforge.net/projects/wav-prg/files/audiotap/2.2/[Audiotap] is a graphical interface program made for Windows (but also working on Wine) that can convert Commodore `TAP` files to `WAV` audio files.
+
 <<<
 
 ==== Miniduino

doc/Manual de ZXUNO+.adoc

@@ -1,6 +1,6 @@
 = Manual de ZXUNO+
 :author: kounch
-:revnumber: 0.4
+:revnumber: 0.5
 :doctype: book
 :front-cover-image: image:img/portadauno.jpg[]
 :email: kounch@users.noreply.github.com
@@ -387,7 +387,7 @@ https://www.facebook.com/groups/DerbyPro[DerbyPro o Derby{pp}] es una ROM mejora
 
 Se puede descargar la ROM, un manual de usuario y otos ficheros del https://www.facebook.com/groups/DerbyPro[grupo púbilco oficial de Facebook].
 
-Puesto que se trata de una ROM de 64K con soporte para nuevo hardware, se pueden usar estas opciones al <<#_zx123_tool,añadirla a la SPI flash>>:
+Esta ROM de 64K tiene soporte para nuevo hardware, incluyendo el uso de comandos de esxdos desde 128 BASIC, así que se pueden usar estas opciones al <<#_zx123_tool,añadirla a la SPI flash>>:
 
 [%header,cols=2*] 
 |===
@@ -494,6 +494,7 @@ Aunque guarda una base comúnde código con muchas versiones de Sinclair BASIC (
 - Introducción de caracteres de terminal (CTRL, META).
 - Buffer de teclado.
 - Soporte para teclados completos.
+- Soporte completo de las características adicionales del core de Spectrum de ZX-Uno
 
 Las principales diferencias con Microsoft BASIC son:
 
@@ -1832,6 +1833,151 @@ Ahora, para cargar el archivo deseado, escribir `LOAD "<nombre>",8` (donde `<nom
 
 <<<
 
+=== Commodore PET
+
+El https://en.wikipedia.org/wiki/Commodore_PET[Commodore PET (Personal Electronic Transactor)] fue una línea de ordenadores domésticos producida por Commodore a partir de 1977. 
+
+La versión para ZX-Uno ha sido https://www.zxuno.com/forum/viewtopic.php?f=50&t=683&start=20[desarrollada por Jepalza], basada en el proyecto https://www.skibo.net/projects/pet2001fpga/[pet2001fpga].
+
+Características:
+
+- Carga usando la entrada de audio
+- Sólo funciona en VGA
+
+==== Formato de Tarjeta SD
+
+Este core no utiliza la tarjeta SD.
+
+==== Teclado
+
+El teclado está con la distribución en inglés.
+
+===== Teclas especiales y botones
+
+Durante la ejecución del core:
+
+- `F1`: Cancelar carga desde cinta
+- `Alt`: Permite escribir en modo gráfico
+
+==== Guía básica
+
+Se puede cargar desde una cinta (u otro dispositivo externo de audio) con el comando `LOAD`. Una vez finalizadada la carga, normalmente, se ha de escribir `RUN` y pulsar `ENTER`.
+
+[NOTE]
+====
+El software Maxduino incorporando en <<<<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore PET.
+====
+
+[TIP]
+====
+Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Audiotap>> con los ficheros `TAP` de cinta de Commodore.
+====
+
+<<<
+
+=== Commodore VIC-20
+
+El https://es.wikipedia.org/wiki/Commodore_VIC-20[Commodore VIC-20] (Commodore VC20 en Alemania, VIC-1001 en Japón) fue un ordenador doméstico de 8 bits fabricado y diseñado por Commodore Business Machines, lanzado en junio de 1980, cerca de 3 años después del Commodore PET.
+
+La versión para ZX-Uno ha sido desarrollada por McLeod y Quest
+
+Características principales:
+
+- Expansión de 32K de RAM. Para mayor compatibilidad se puede desactivar.
+- Carga usando la entrada de audio
+- Soporte para video compuesto y VGA
+- Soporte de joystick
+
+==== Formato de Tarjeta SD
+
+Este core no utiliza la tarjeta SD.
+
+==== Teclado
+
+===== Teclas especiales y botones
+
+Durante la ejecución del core:
+
+- `F9` a `F11`: Cargar cartuchos incorporados al core
+- `-` del teclado numérico: Cambiar la polaridad de la entrada de audio. El LED rojo se enciende cuando la polaridad está invertida
+- `Bloq. Desp`: para cambiar entre modo de video compuesto y VGA
+- `F11`: Seleccionar la asignación del joystick al puerto 0 o al puerto 1
+- `Bloq. Num`: Reset desactivando la ampliación de memoria de 32K (activa por defecto)
+- `F12`: Reset activando la ampliación de memoria
+- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima del enter
+
+==== Guía básica
+
+Se puede cargar desde una cinta (u otro dispositivo externo de audio) con el comando `LOAD`. Una vez finalizadada la carga, normalmente, se ha de escribir `RUN` y pulsar `ENTER`.
+
+[NOTE]
+====
+El software Maxduino incorporando en <<<<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore VIC-20.
+====
+
+[TIP]
+====
+Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Audiotap>> con los ficheros `TAP` de cinta de Commodore.
+====
+
+<<<
+
+=== Jupiter ACE
+
+El https://es.wikipedia.org/wiki/Jupiter_Ace[Jupiter ACE] fue un microordenador británico lanzado al mercado en 1982 por la empresa Jupiter Cantab.
+
+El core para ZX-Uno ha sido desarrollado por McLeod y mejorado por Azesmbog, y tiene, entre otras, las siguientes características:
+
+- Soporte para carga desde dispositivos de audio externo
+- Soporte de acceso a la tarjeta SD (implementando https://zx-pk.ru/threads/29892-sd-karta-i-sdos-dlya-8i-bitnykh-pk.html[SDOS])
+
+==== Formato de Tarjeta SD
+
+Se puede utilizar una tarjeta SD, con la primera partición en formato FAT16, para almacenar ficheros en formato `.TAP` de Jupiter ACE. Estos se pueden conseguir, por ejemplo, en la web de https://www.jupiter-ace.co.uk/index.html[Jupiter ACE Archive].
+
+==== Teclado
+
+===== Teclas especiales y botones
+
+Durante la ejecución del core:
+
+- `F1` a `F4`: Modos Turbo
+- `F12`: Soft Reset
+- `Ctrl+Alt+Supr`: Reset
+- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima del enter
+
+==== Guía básica
+
+Desde BASIC, se puede cargar desde una cinta (u <<#_miniduino,otro dispositivo externo de audio>>) con el comando `LOAD <nombre>`.
+
+[CAUTION]
+====
+Los ficheros `TAP` de Jupiter ACE son diferentes de los de ZX Spectrum, y, para poder utilizarse con miniduino, han de ser convertidos previamente a `TZX` con la utilidad `acetap2zx` disponible en el https://guest:zxuno@svn.zxuno.com/svn/zxuno/software/jupiter_ace/utils[repositorio de ZX-Uno] (Usuario `guest`, contraseña `zxuno`).
+====
+
+Para cargar ficheros de cinta desde la tarjeta SD, se debe acceder a SDOS escribiendo
+
+[source]
+----
+61440 call
+----
+
+Ahora, con instrucciones como `CD`, `DIR` se puede llegar hasta el directorio donde se encuentre el fichero `TAP` a cargar. Para cargar un fichero de cinta `.TAP` se tiene que escribir sólo el nombre, sin la extensión (por ejemplo, para un fichero `JUEGO.TAP` se debe escribir `JUEGO`).
+
+[TIP]
+====
+Todos los comandos de SDOS se deben escribir en letras mayúsculas.
+====
+
+Una vez la cinta ha cargado, escribir el comando necesario para iniciar el programa.
+
+[NOTE]
+====
+En lugar de BASIC como otros sistemas, el Jupiter ACE utiliza https://es.wikipedia.org/wiki/Forth[Forth]. Para ver los comandos disponibles (incluyendo los que inician un programa cargado desde cinta), se tiene que utilizar `vlist`.
+====
+
+<<<
+
 === MSX
 
 MSX1FPGA es un proyecto para clonar MSX1 en una FPGA. El desarrollo original es de Fabio Belavenuto y se encuentra disponible https://github.com/fbelavenuto/msx1fpga[en GitHub].
@@ -2053,7 +2199,7 @@ Si no estuviera ya, <<#_cores,instalar el core smartROM>> en el ZXUNO+.
 
 El computador personal https://es.wikipedia.org/wiki/ZX81[Sinclair ZX81], lanzado por Sinclair Research en 1981, fue el de menor precio de la época.
 
-La versión para ZXUNO+ ha sido https://www.zxuno.com/forum/viewtopic.php?f=54&t=703[creada por jepalza] y está basada en la http://zxgate.sourceforge.net/[implementación anterior de un ZX97].
+La versión para ZXUNO+ ha sido https://www.zxuno.com/forum/viewtopic.php?f=54&t=703[creada por Jepalza] y está basada en la http://zxgate.sourceforge.net/[implementación anterior de un ZX97].
 
 ==== Formato de Tarjeta SD
 
@@ -2161,7 +2307,7 @@ Los pasos a seguir en este caso son:
 
 A continuación se indican algunos de los muchos programas que existen para distintos sistemas operativos, y que pueden exportar ficheros de cinta a ficheros de audio.
 
-https://www.alessandrogrussu.it/tapir/index.html[Tapir] es un programa con interfaz gráfica para Windows (pero que se puede usar también con Wine en Linux o Mac) que permite cargar ficheros `TZX` y `TAP` y exportarlos como `WAV` de audio
+https://www.alessandrogrussu.it/tapir/index.html[Tapir] es un programa con interfaz gráfica para Windows (pero que se puede usar también con Wine en Linux o Mac) que permite cargar ficheros `TZX` y `TAP` y exportarlos como `WAV` de audio.
 
 `tape2wav` de https://fuse-emulator.sourceforge.net/[Fuse Utilities] es una utilidad de línea de comandos que exporta desde ficheros `TZX` `PZX` y `TAP` a `WAV`. Disponibles para muchos sistemas operativos distintos.
 
@@ -2169,6 +2315,8 @@ https://www.alessandrogrussu.it/tapir/index.html[Tapir] es un programa con inter
 
 `tsx2wav` en https://github.com/nataliapc/MSX_devs/tree/master/TSXphpclass[TSXphpclass] es una utilidad en PHP y que sirve para exportar desde ficheros `TSX` a `WAV`.
 
+https://sourceforge.net/projects/wav-prg/files/audiotap/2.2/[Audiotap] es un programa con interfaz gráfica para Windows (pero que se puede usar también con Wine en Linux o Mac) que permite convertir ficheros `TAP` de Commodore como `WAV` de audio.
+
 <<<
 
 ==== Miniduino
@@ -2588,7 +2736,7 @@ sudo apt-get update
 sudo apt-get install git autoconf libtool make pkg-config
 sudo apt-get install libusb-1.0-0 libusb-1.0-0-dev telnet
 sudo apt-get install libusb-dev libftdi-dev
-git clone, git://git.code.sf.net/p/openocd/code openocd-code
+git clone git://git.code.sf.net/p/openocd/code openocd-code
 cd openocd-code/
 ./bootstrap
 ./configure --enable-usb_blaster --enable-sysfsgpio --enable-bcm2835gpio