Añadida sección dedicada a I2S

Añadidos agradecimientos

doc/English ZXDOS+ and gomaDOS+ Manual.adoc

@@ -1,6 +1,6 @@
 = ZXDOS+ and gomaDOS+ Manual
 :author: kounch
-:revnumber: 1.4.0
+:revnumber: 1.4.1
 :doctype: book
 :front-cover-image: image:img/portada.jpg[]
 :email: kounch@users.noreply.github.com
@@ -25,6 +25,16 @@ ZXDOS+ and gomaDOS+ official web page is https://zxdos.forofpga.es.
 
 Most of the functions and features of ZXDOS+ and gomaDOS+ are the same, so this document will generally talk about ZXDOS+, indicating the differences with gomaDOS+ where necessary.
 
+=== Aknowledgements
+
+A lot of the content of this manual is based on information previously shared:
+
+- At https://www.forofpga.es/[foroFPGA]
+- At https://www.zxuno.com/forum/[ZX-Uno forum]
+- Several existing FAQ, mostly the original version https://uto.speccy.org/zxunofaq.html[by @uto_dev], and the latest one http://desubikado.sytes.net/zx-uno-faq-version-desubikado/[by @desUBIKado]
+
+Without the previous work of all of these people (and more), this manual wouldn't exist.
+
 <<<
 
 === Ports and Connectors
@@ -1371,7 +1381,7 @@ The user manual is available to download at https://www.specnext.com/zx-spectrum
 
 [TIP]
 ====
-To use a Raspberry Pi as accelerator, you need a core version with Pi Zero support, and the RTC+I2S+Pizero addon. See the other hardware <<#_rtci2spizero_addon,section>> for more info.
+To use a Raspberry Pi as accelerator, you need a core version with Pi Zero support, and the RTC+I^2^S+Pizero addon. See the other hardware <<#_rtci2spizero_addon,section>> for more info.
 ====
 
 <<<
@@ -1403,6 +1413,7 @@ While the core is running:
 - `F7` (`Caps Shift+Symbol Shift+7` on gomaDOS+): Scanlines
 - `F9` (`Caps Shift+Symbol Shift+9` on gomaDOS+): NMI
 - `F10` (`Caps Shift+Symbol Shift+0` on gomaDOS+): divMMC NMI. Simulates Drive button. If used with Caps Shift it forces a rescan of drives and a reload of the boot screen under esxDOS
+- `F12` (`Caps Shift+Symbol Shift+W in gomaDOS+): Switch between standard audio and I^2^S output, if the <<#_addon_rtci2spizero,RTC+I^2^S+PI0 addon>> is connected. Take note that enabling I^2^S disables partially the Raspberry Pi audio.
 
 <<<
 
@@ -2475,9 +2486,27 @@ If everything has been done correctly the Miniduino will restart and show on the
 
 <<<
 
-=== RTC+I2S+PIzero addon
+=== RTC+I^2^S+PIzero addon
 
-This hardware extra, has a https://en.wikipedia.org/wiki/Real-time_clock[real-time clock (RTC)], a https://en.wikipedia.org/wiki/I2S[I2S] UDA1334A chip and a 40-pin header where you can connect a Raspberry Pi computer which, the NexPI software, will work a as a <<#_zx_spectrum_next,ZX Spectrum Next core>> accelerator board.
+This hardware extra, has a https://en.wikipedia.org/wiki/Real-time_clock[real-time clock (RTC)], a I^2^S UDA1334A chip and a 40-pin header where you can connect a Raspberry Pi computer which, the NexPI software, will work a as a <<#_zx_spectrum_next,ZX Spectrum Next core>> accelerator board.
+
+==== I^2^S
+
+https://en.wikipedia.org/wiki/I2S[I^2^S], also known as Inter-IC Sound, Integrated Interchip Sound, or IIS, is a standard for tramsmitting digital audio from one device to another. On ZXDOS+, this allows to send digital audio from a core to the addon, obtaining a better playback quality.
+
+===== Supported cores
+
+When writing this, the following cores have I^2^S support:
+
+- <<#_msx,MSX>> (since version 1.3)
+- <<#_zx_spectrum_next,ZX Spectrum Next>>
+
+[NOTE]
+====
+In the ZX Spectrum core, since the line is shared between I^2^S with Raspberry Pi audio, you can not use both at the same time, and you have to switch between them using the `F12` key (`Caps Shift+Symbol Shift+W` on gomaDOS+).
+====
+
+<<<
 
 ==== Raspberry Pi
 

doc/Manual de ZXDOS+ y gomaDOS+.adoc

@@ -1,6 +1,6 @@
 = Manual de ZXDOS+ y gomaDOS+
 :author: kounch
-:revnumber: 1.4.0
+:revnumber: 1.4.1
 :doctype: book
 :front-cover-image: image:img/portada.jpg[]
 :email: kounch@users.noreply.github.com
@@ -25,6 +25,16 @@ La página oficial de ZXDOS+ y gomaDOS+ es https://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.
 
+=== Agradecimientos
+
+Gran parte del contenido de este documento se basa en información compartida anteriormente:
+
+- En https://www.forofpga.es/[foroFPGA]
+- En el https://www.zxuno.com/forum/[foro de ZX-Uno]
+- En los varios FAQ existentes, principalmente la versión original https://uto.speccy.org/zxunofaq.html[de @uto_dev], y la versión más moderna http://desubikado.sytes.net/zx-uno-faq-version-desubikado/[de @desUBIKado]
+
+Sin el trabajo previo de todas estas personas (y más), ese manual no podría existir.
+
 <<<
 
 === Puertos y Conectores
@@ -1372,7 +1382,7 @@ El manual de uso se puede descargar desde https://www.specnext.com/zx-spectrum-n
 
 [TIP]
 ====
-Para poder utilizar una Raspberry Pi, se necesita una versión del Core con el soporte necesario, y el addon RTC+I2S+Pizero. Ver la <<#_addon_rtci2spizero,sección correspondiente>> de otro hardware para más detalles.
+Para poder utilizar una Raspberry Pi, se necesita una versión del Core con el soporte necesario, y el addon RTC+I^2^S+Pizero. Ver la <<#_addon_rtci2spizero,sección correspondiente>> de otro hardware para más detalles.
 ====
 
 <<<
@@ -1404,6 +1414,7 @@ Durante la ejecución del core:
 - `F7` (`Caps Shift+Symbol Shift+7` en gomaDOS+): Scanlines
 - `F9` (`Caps Shift+Symbol Shift+9` en gomaDOS+): NMI
 - `F10` (`Caps Shift+Symbol Shift+0` en gomaDOS+): divMMC NMI. Simula la pulsación del botón Drive. Si se usa con mayúsculas, fuerza volver a buscar unidades de almacenamiento y cargar la pantalla de arranque en esxdos
+- `F12` (`Caps Shift+Symbol Shift+W en gomaDOS+): Alternar entre la salida audio estándar y la salida I^2^S, si está conectado el <<#_addon_rtci2spizero,addon RTC+I^2^S+PI0>>. Notar que activar la salida I^2^S inhabilita parcialmente el sonido de la Raspberry Pi.
 
 <<<
 
@@ -2488,9 +2499,27 @@ Si todo se ha hecho correctamente se verá cómo el Miniduino se reinicia y en l
 
 <<<
 
-=== Addon RTC+I2S+PIzero
+=== Addon RTC+I^2^S+PIzero
 
-Este complemento de hardware, compatible con ZXDOS+, GomaDOS+ y neptUNO, incorpora un https://es.wikipedia.org/wiki/Reloj_en_tiempo_real[reloj en tiempo real (RTC)], un https://es.wikipedia.org/wiki/I%C2%B2S[chip I2S] UDA1334A y una cabecera de 40 pines donde se puede conectar una Raspberry Pi que, con el software adecuado, se puede utilizar como placa aceleradora del <<#_zx_spectrum_next,core de ZX Spectrum Next>>.
+Este complemento de hardware, compatible con ZXDOS+, GomaDOS+ y neptUNO, incorpora un https://es.wikipedia.org/wiki/Reloj_en_tiempo_real[reloj en tiempo real (RTC)], un chip I^2^S UDA1334A y una cabecera de 40 pines donde se puede conectar una Raspberry Pi que, con el software adecuado, se puede utilizar como placa aceleradora del <<#_zx_spectrum_next,core de ZX Spectrum Next>>.
+
+==== I^2^S
+
+https://es.wikipedia.org/wiki/I%C2%B2S[I^2^S], conocido también como Inter-IC Sound, Integrated Interchip Sound, o IIS, es un estándar que se utiliza para transmitir audio digital entre circuitos. En el caso del ZXDOS+, esto permite enviar el sonido de forma digital desde un core al addon, ofreciendo así una mejor calidad en la reproducción.
+
+===== Cores con soporte
+
+En el momento de escribirse estas líneas, hay los siguientes cores con soporte para I^2^S:
+
+- <<#_msx,MSX>> (desde la versión 1.3)
+- <<#_zx_spectrum_next,ZX Spectrum Next>>
+
+[NOTE]
+====
+En el core de ZX Spectrum Next, debido a que se comparte la línea I^2^S con el audio de la Raspberry Pi, no es posible utilizar simultáneamente las dos, y se ha de conmutar una u otra usando la tecla `F12` (`Caps Shift+Symbol Shift+W` en gomaDOS+).
+====
+
+<<<
 
 ==== Raspberry Pi