diff --git a/doc/English ZXUNO+ Manual.adoc b/doc/English ZXUNO+ Manual.adoc index 0d00297..5aa7b5e 100644 --- a/doc/English ZXUNO+ Manual.adoc +++ b/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 "",8` (where `` <<< +=== 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 `. + +[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 diff --git a/doc/English ZXUNO+ Manual.pdf b/doc/English ZXUNO+ Manual.pdf index 70e65e3..d8d1e85 100644 Binary files a/doc/English ZXUNO+ Manual.pdf and b/doc/English ZXUNO+ Manual.pdf differ diff --git a/doc/Manual de ZXUNO+.adoc b/doc/Manual de ZXUNO+.adoc index 84b2373..c19806f 100644 --- a/doc/Manual de ZXUNO+.adoc +++ b/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 "",8` (donde `> 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 `. + +[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 diff --git a/doc/Manual de ZXUNO+.pdf b/doc/Manual de ZXUNO+.pdf index d122a5d..7b6d1c4 100644 Binary files a/doc/Manual de ZXUNO+.pdf and b/doc/Manual de ZXUNO+.pdf differ