Manual 1.4.3 de ZXDOS+

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

doc/English ZXDOS+ and gomaDOS+ Manual.adoc

@@ -1,6 +1,6 @@
 = ZXDOS+ and gomaDOS+ Manual
 :author: kounch
-:revnumber: 1.4.2
+:revnumber: 1.4.3
 :doctype: book
 :front-cover-image: image:img/portada.jpg[]
 :email: kounch@users.noreply.github.com
@@ -1923,6 +1923,55 @@ 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 ZXDOS+ core has these features:
+
+- 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:
+
+- `Ctrl+Alt+Del`: Reset.
+
+<<<
+
+==== 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.
@@ -2296,6 +2345,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://github.com/RW-FPGA-devel-Team/lynx2wav[Lynx2Wav] is a program that can convert Camputers Lynx `TAP` files to `WAV` audio.
+
 <<<
 
 ==== Miniduino
@@ -2390,6 +2441,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.
@@ -3311,6 +3386,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 ZXDOS+ y gomaDOS+.adoc

@@ -1,6 +1,6 @@
 = Manual de ZXDOS+ y gomaDOS+
 :author: kounch
-:revnumber: 1.4.2
+:revnumber: 1.4.3
 :doctype: book
 :front-cover-image: image:img/portada.jpg[]
 :email: kounch@users.noreply.github.com
@@ -1924,6 +1924,56 @@ En él se pueden activar o desactivar 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 ZXDOS+ tiene estas características:
+
+- 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:
+
+- `Ctrl+Alt+Supr`: Reset
+
+<<<
+
+==== 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.
@@ -2303,6 +2353,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://github.com/RW-FPGA-devel-Team/lynx2wav[Lynx2Wav] es un programa que permite convertir ficheros `TAP` de Camputers Lynx como `WAV` de audio.
+
 <<<
 
 ==== Miniduino
@@ -2402,6 +2454,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.
@@ -3332,6 +3408,13 @@ 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]