diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.adoc b/doc/English ZXDOS+ and gomaDOS+ Manual.adoc index 72398a0..ab08e97 100644 --- a/doc/English ZXDOS+ and gomaDOS+ Manual.adoc +++ b/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 diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.pdf b/doc/English ZXDOS+ and gomaDOS+ Manual.pdf index 6a9d5a9..9188c1e 100644 Binary files a/doc/English ZXDOS+ and gomaDOS+ Manual.pdf and b/doc/English ZXDOS+ and gomaDOS+ Manual.pdf differ diff --git a/doc/Manual de ZXDOS+ y gomaDOS+.adoc b/doc/Manual de ZXDOS+ y gomaDOS+.adoc index da91775..2926ef2 100644 --- a/doc/Manual de ZXDOS+ y gomaDOS+.adoc +++ b/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 diff --git a/doc/Manual de ZXDOS+ y gomaDOS+.pdf b/doc/Manual de ZXDOS+ y gomaDOS+.pdf index f85c1da..08f5047 100644 Binary files a/doc/Manual de ZXDOS+ y gomaDOS+.pdf and b/doc/Manual de ZXDOS+ y gomaDOS+.pdf differ