Manual 0.6 de ZXUNO+

Añadido core de Camputers Lynx
Añadidas utilidades para TSX Y TZX

doc/English ZXUNO+ Manual.adoc

@@ -1,6 +1,6 @@
 = ZXUNO+ Manual
 :author: kounch
-:revnumber: 0.5
+:revnumber: 0.6
 :doctype: book
 :front-cover-image: image:img/portadauno.jpg[]
 :email: kounch@users.noreply.github.com
@@ -1507,6 +1507,7 @@ The following options are available:
 - Exit
 
 <<<
+
 === Atari 2600
 
 https://en.wikipedia.org/wiki/Atari_2600[Atari 2600]  is a home video game console originally branded as the Atari Video Computer System (Atari VCS).
@@ -1561,6 +1562,59 @@ The following options are available:
 
 <<<
 
+=== Camputers Lynx
+
+https://en.wikipedia.org/wiki/Camputers_Lynx[The Lynx] was an 8-bit British home computer that was first released in early 1983 as a 48kB model.Several models were available with 48kB, 96kB or 128 kB RAM. 
+
+The ZXUNO+ core has these features:
+
+- 96K RAM
+- Joystick support
+- Only RGB/Composite Video out
+
+==== SD card format
+
+This core does not use the SD card
+
+==== Keyboard
+
+===== Special keys and buttons
+
+While running the core:
+
+- `F8`: Switch the option to consider port $80 bits 2 and 3, so that Level 9 games are displayed properly.
+- `Ctrl+Alt+Del`: 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 commands like:
+
+[source]
+----
+TAPE n
+LOAD "NAME"
+----
+
+Where `n` is a number (usually 3 or 5), and `NAME` is mandatory, and the name of the program to load.
+
+If you don't know the name to load, you can guess with the same command sequence, but writing `LOAD ""`.
+
+Binary files are loaded with `MLOAD` instead of `LOAD`.
+
+[NOTE]
+====
+Maxduino, which is used in <<#_miniduino,miniduino>> does not, at this moment, native support for Lynx tape files.
+====
+
+You can use programs like  <<#_audio_file_conversion,Lynx2Wav>> with Lynx `TAP` files. The resulting audio files can be embedded inside of TSX or TZX with tools like <<#_creación_de_ficheros_tzx_o_tsx_desde_otros_formatos,MakeTSX or RetroConverter>>.
+
+The http://retrowiki.es/viewtopic.php?f=31&t=200036835[lince] script makes all this process easier, creating directly Maxduino `TZX` compatible files from Lynx `TAP` files.
+
+<<<
+
 === ColecoVision
 
 https://en.wikipedia.org/wiki/ColecoVision[ColecoVision] is Coleco Industries' home video-game console that was released in August 1982.
@@ -2299,6 +2353,8 @@ https://www.alessandrogrussu.it/tapir/index.html[Tapir] is a GUI program for Win
 
 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.
 
+https://github.com/RW-FPGA-devel-Team/lynx2wav[Lynx2Wav] is a program that can convert Camputers Lynx `TAP` files to `WAV` audio.
+
 <<<
 
 ==== Miniduino
@@ -2393,6 +2449,30 @@ When in pause (tape block browser:
 
 <<<
 
+===== Making TZX or TSX files from other formats
+
+While there are same tape file formats (Commodore, Camputers Lynx, etc.) not supported by Maxduino, there are some programs that can, wich can, more or less successfully, embed <<#_audio_file_conversion,audio data>> in a `TSX` or `TZX` file, which then can be used with Miniduino.
+
+====== MakeTSX
+
+You can use the following command with NataliaPC's https://github.com/nataliapc/makeTSX/releases[MakeTSX] to create a `TSX` file with embedded audio:
+
+[source,shell]
+----
+...MakeTSX -b15 -wav audio_file.wav -tsx new_file.tsx
+----
+
+====== RetroConverter
+
+Jorge Fuertes https://github.com/jorgefuertes/retroconverter/releases[RetroConverter] can create a `TZX` file with a command like this:
+
+[source,shell]
+----
+...retroconv audio_file.wav new_file.tzx
+----
+
+<<<
+
 ===== Maxduino firmware upgrade
 
 Maxduino firmware is periodically updated and improved. You can track the changes and improvements either at the  https://www.va-de-retro.com/foros/viewtopic.php?t=5541&start=9999[forums] or at the https://github.com/rcmolina/MaxDuino_BETA[GitHub project page]. To take advantage of this improvements, the Miniduino flash image must be flashed with the updated firmware version.
@@ -2915,6 +2995,14 @@ https://github.com/RW-FPGA-devel-Team/Videopac-G7000[Videopac G7000 / Odyssey2 f
 
 http://www.videopac.org/manuals/voice.pdf[Odtyssey Speech And Sound Effects Module Manual]
 
+https://github.com/rcmolina/MaxDuino_BETA/blob/master/MANUAL%20por%20desUBIKado/MAXDUINO%20Gu%C3%ADa%20de%20uso.pdf[Maxduino - guía de uso]
+
+https://github.com/nataliapc/makeTSX/releases[MakeTSX]
+
+https://github.com/jorgefuertes/retroconverter/releases[RetroConverter]
+
+http://retrowiki.es/viewtopic.php?f=31&t=200036835[Lince Script]
+
 https://catleytech.com/?p=2679[Programming a Spartan 6 with a Raspberry Pi]
 
 https://www.zxuno.com/forum/viewtopic.php?f=25&t=375[Tutorial para desbriquear el ZX-Uno con una Raspberry]

doc/Manual de ZXUNO+.adoc

@@ -1,6 +1,6 @@
 = Manual de ZXUNO+
 :author: kounch
-:revnumber: 0.5
+:revnumber: 0.6
 :doctype: book
 :front-cover-image: image:img/portadauno.jpg[]
 :email: kounch@users.noreply.github.com
@@ -1571,6 +1571,60 @@ En él se pueden activar, desactivar o configurar las siguientes opciones:
 
 <<<
 
+=== Camputers Lynx
+
+
+El https://es.wikipedia.org/wiki/Camputers_Lynx[Lynx] fue un ordenador doméstico británico de 8 bits lanzado a principios de 1983 por la compañía Camputers. Se lanzaron en total tres modelos, con 48kB, 96kB o 128kB de RAM. 
+
+La versión para ZXUNO+ tiene estas características:
+
+- Memoria de 96K
+- Soporte para joystick
+- Sólo funciona con RGB/Vídeo Compuesto
+
+==== Formato de Tarjeta SD
+
+Este core no utiliza la tarjeta SD.
+
+==== Teclado
+
+===== Teclas especiales y botones
+
+Durante la ejecución del core:
+
+- `F8`: Activar o desactivar el tener en cuenta los bits 2 y 3 del puerto $80, para que se vean bien los juegos de Level 9.
+- `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 suele cargar desde una cinta (u <<#_miniduino,otro dispositivo externo de audio>>) con la secuencia de comandos:
+
+[source]
+----
+TAPE n
+LOAD "NOMBRE"
+----
+
+Donde `n` es un número que suele ser 3 o 5, según como se haya realizado la grabación, y `NOMBRE` es, obligatoriamente el nombre a cargar desde la cinta.
+
+Si no se sabe el nombre a cargar, se puede averiguar con la misma secuencia de comandos, pero escribiendo `LOAD ""`.
+
+Para ficheros binarios, se debe usar `MLOAD` en vez de `LOAD`.
+
+[NOTE]
+====
+El software Maxduino incorporando en <<<<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta `TAP` de Lynx.
+====
+
+Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Lynx2Wav>> con los ficheros `TAP` de cinta de Lynx. Los ficheros de audio obtenidos se pueden embeber a su vez dentro de ficheros TSX o TZX con herramientas como <<#_creación_de_ficheros_tzx_o_tsx_desde_otros_formatos,MakeTSX o RetroConverter>>.
+
+El script http://retrowiki.es/viewtopic.php?f=31&t=200036835[lince] facilita todo este proceso, permitiendo crear directamente ficheros `TZX` compatibles con Maxduino desde ficheros `TAP` de Lynx.
+
+<<<
+
 === ColecoVision
 
 https://es.wikipedia.org/wiki/ColecoVision[ColecoVision] es una consola de videojuegos lanzada al mercado por la empresa Coleco.
@@ -2317,6 +2371,8 @@ https://www.alessandrogrussu.it/tapir/index.html[Tapir] es un programa con inter
 
 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.
 
+https://github.com/RW-FPGA-devel-Team/lynx2wav[Lynx2Wav] es un programa que permite convertir ficheros `TAP` de Camputers Lynx como `WAV` de audio.
+
 <<<
 
 ==== Miniduino
@@ -2416,6 +2472,30 @@ Para obtener información mucho más detallada, se puede consultar el manual ofi
 
 <<<
 
+===== Creación de ficheros TZX o TSX desde otros formatos
+
+Existen algunos formatos de cinta (Commodore, Camputers Lynx, etc.) que, por el momento, no están directamente soportados por Maxduino. No obstante, existen algunos programas que pueden permitir, con mayor o menor éxito, transformar ficheros de cinta desde <<#_conversión_a_fichero_de_audio,formato de audio>> a `TSX` o `TZX`, y así poder utilizarlos con Miniduino.
+
+====== MakeTSX
+
+Para usar https://github.com/nataliapc/makeTSX/releases[MakeTSX] de NataliaPC y crear un fichero `TSX` con audio embebido, se ha de usar un comando como el siguiente:
+
+[source,shell]
+----
+...MakeTSX -b15 -wav fichero_audio.wav -tsx fichero_nuevo.tsx
+----
+
+====== RetroConverter
+
+Para utilizar https://github.com/jorgefuertes/retroconverter/releases[RetroConverter] de Jorge Fuertes, para crear un fichero `TZX` con audio embebido, usar un comando como:
+
+[source,shell]
+----
+...retroconv fichero_audio.wav fichero_nuevo.tzx
+----
+
+<<<
+
 ===== Actualización de firmware Maxduino
 
 El firmware Maxduino es actualizado y mejorado periódicamente. Se puede hacer un seguimiento de los cambios y mejoras en el https://www.va-de-retro.com/foros/viewtopic.php?t=5541&start=9999[foro] o bien en la https://github.com/rcmolina/MaxDuino_BETA[página del proyecto en GitHub]. Para poder aprovechar estas mejoras se ha de actualizar la memoria flash del Miniduino con la versión de firmware correspondiente.
@@ -2932,6 +3012,12 @@ http://www.videopac.org/manuals/voice.pdf[Odtyssey Speech And Sound Effects Modu
 
 https://github.com/rcmolina/MaxDuino_BETA/blob/master/MANUAL%20por%20desUBIKado/MAXDUINO%20Gu%C3%ADa%20de%20uso.pdf[Maxduino - guía de uso]
 
+https://github.com/nataliapc/makeTSX/releases[MakeTSX]
+
+https://github.com/jorgefuertes/retroconverter/releases[RetroConverter]
+
+http://retrowiki.es/viewtopic.php?f=31&t=200036835[Lince Script]
+
 https://github.com/rogerclarkmelbourne/Arduino_STM32/wiki/Installation[Hardware files to support STM32 based boards on Arduino version 1.8.x]
 
 https://catleytech.com/?p=2679[Programming a Spartan 6 with a Raspberry Pi]