Manual 0.12 de ZXUNO+

Oric Atmos
SAM Coupé
Sega Master System

doc/English ZXUNO+ Manual.adoc

@@ -1,6 +1,6 @@
 = ZXUNO+ Manual
 :author: kounch
-:revnumber: 0.11
+:revnumber: 0.12
 :doctype: book
 :front-cover-image: image:img/portadauno.jpg[]
 :email: kounch@users.noreply.github.com
@@ -1996,8 +1996,9 @@ You can use a SD card with the first partition in FAT16 format, where you can st
 
 While the core is running:
 
-- `F1` ti `F4`: Turbo Modes
+- `F1` to `F4`: Turbo Modes
 - `F12`: Soft Reset
+- `Ctrl+Alt+F5`: NMI
 - `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`
 
@@ -2096,7 +2097,7 @@ While running the core:
 - `Left ALT`: MSX GRAPH 
 - `Right ALT`: MSX CODE
 - `Page Up`: MSX SELECT
-- `Start`: MSX HOME (`Shift+HOME`: CLS)
+- `Home`: MSX HOME (`Shift+HOME`: CLS)
 - `End`: MSX STOP
 - `Ñ` or `Windows`: MSX DEAD
 
@@ -2215,6 +2216,100 @@ The following options are available:
 
 <<<
 
+=== Oric Atmos
+
+The https://en.wikipedia.org/wiki/Oric#Oric_Atmos[Oric Atmos] was the name used by UK-based Tangerine Computer Systems for one 6502-based home computer sold in the 1980s, primarily in Europe.
+
+The ZX-Uno core has these features:
+
+- VGA / RGB video Out
+- NMI
+- DOS-8D (based on https://en.wikipedia.org/wiki/Pravetz_computers#8-bit_architecture[Pravetz 8d], a bulgarian clone of Oric Atmos)
+
+For more information, see https://zxuno.com/forum/viewtopic.php?f=19&t=7[the ZX-Uno forum].
+
+==== SD card format
+
+The SD card needs an exclusive format, so it cannot be used with other cores. It's based on concatenating `NIB` disk image file data. To convert disk images from other format (`DSK` or `DO`), you can use `dsk2nib` utility (the resulting image files must be 232960 bytes long).
+
+[WARNING]
+====
+This process can't be undone, and it will remove any content that there was previously in the SD card.
+====
+
+===== Windows
+
+Concatenate the disk images (with a maximum of 20) using `COPY`:
+
+[source,shell]
+----
+COPY /B image1.nib + image2.nib + (...) + image20.nib oric_discs.img
+----
+
+Dump the new file to the SD card, for example, using http://hddguru.com/software/HDD-Raw-Copy-Tool/[HDD Raw Copy Tool].
+
+===== MacOS and Linux
+
+Concatenate the disk images (with a maximum of 20) using `cat`:
+
+[source,shell]
+----
+cat imagen.nib image2.nib (...) image20.nib > oric_discs.img
+----
+
+Dump the new file to the SD card, using `dd`:
+
+[source,shell]
+----
+sudo umount /dev/...
+sudo dd if=oric_discs.img of=/dev/...
+----
+
+<<<
+
+==== Keyboard
+
+This is the keyboard layout:
+
+[.text-center] 
+image:img/keyboardoric.png[pdfwidth=80%]
+
+=====  Special keys and buttons   
+
+Durante la ejecución del core:
+
+- `Scroll Lock`: Change between RGB/Composite and VGA video mode
+- `Home`: Show debugging data on screen (Current disk track -two digits-, disk image number -two digit-, and program counter -four digits-)
+- `End`: NMI
+- `Home+End`: Reset
+- `Page Down`: Load the next disk
+- `Page Up`: Load the previous disk
+
+<<<
+
+==== Basic Guide
+
+[.text-center] 
+image:img/oric.png[pdfwidth=70%]
+
+You can load and enable DOS-8D with the command:
+
+[source]
+----
+CALL800
+----
+
+Then, you can show the files in the current disk with the `DIR` command.
+
+Yo load and run a program, you have to type `-` and the name of the file. This way, for a program named `DEFENDER.EXE`:
+
+[source]
+----
+-DEFENDER.EXE
+----
+
+<<<
+
 === PC XT
 
 https://www.zxuno.com/forum/viewforum.php?f=56[Next186lite] core is an implementation of http://flea.vieju.net/?page_id=20[Next186] core for FleaFPGA and Papilio Pro, pero adapted and trimmed.
@@ -2239,6 +2334,91 @@ See the <<#_cores,corresponding section>> for instructions of how to install the
 
 <<<
 
+=== SAM Coupé
+
+The https://en.wikipedia.org/wiki/SAM_Coupé[SAM Coupé] was an 8-bit British home computer that was first released in late 1989. It was designed to have compatibility with the Sinclair ZX Spectrum, but in 48K mode only. 
+
+The ZX-Uno cores has these features:
+
+- VGA (con scanlines) and RGB / Composite Video Out
+- Full keyboard support
+- SAA1099 sound
+- Software loading via ZXUNO+ audio in port
+
+==== SD card format
+
+This core does not use the SD card
+
+==== Keyboard
+
+===== Special keys and buttons
+
+While the core is running:
+
+- `Ctrl+Alt+F5`: NMI.
+- `Ctrl+Alt+Supr`: Soft reset.
+- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`.
+
+<<<
+
+==== Basic Guide
+
+[.text-center] 
+image:img/samcoupe.png[pdfwidth=70%]
+
+You can only load software from a external tape (or from <<#_miniduino,other external audio device>>) with the command `LOAD""` (or pressing `7` of the numeric keyboard, which is like pressing `F7` of the SAM Coupé keyboard).
+
+[TIP]
+====
+At ZX-Uno SVN repository (https://guest:zxuno@svn.zxuno.com/svn.zxuno.com/svn/zxuno/software/SamCoupe/[here] - User `guest`, password `zxuno`) you can find several programs adapted to TZX tape file.
+====
+
+<<<
+
+=== Sega Master System
+
+The https://en.wikipedia.org/wiki/Master_System[Sega Master System] was a video game console manufactured by Sega.
+
+The ZX-Uno core is based on http://forum.gadgetfactory.net/index.php?/topic/1304-sega-master-system-on-the-papilio-plus/[Ben's original work for Papilio Plus].
+
+Some of the core featurers are:
+
+- VGA and Compostite or RGB video output with PAL sync (50Hz)
+- Joysticks support
+- Joystick emulation via keyboard
+- Loading cartridge image files from the SD card
+
+==== SD card format
+
+You need a SD card with the first partition in FAT16 format to store `BIN` or `SMD` image files of the games to load. ROM files can be inside subdirectories.
+
+See the <<#_cores,corresponding section>> for instructions of how to install the Sega Master System core in ZXUNO+.
+
+==== Keyboard
+
+===== Special keys and buttons
+
+Durante la ejecución del core:
+
+- Cursor or `Q`, `A`, `O`, `P` or joystick 1: Directional controls for player 1
+- `Z`, `Windows` or joystick 1 main fire button: Fire Button 1 for player 1
+- `X`. `Space` or joystick 1 secondary fire button: Fire button 1 for player 1
+- `Pause`: Master System pause button
+- `Scroll Lock`: Change between RGB/Composite and VGA video mode
+- `Ctrl+Alt+Backspace`: Hard reset
+- `F12`: Reset and show the file selection menu
+
+<<<
+
+==== Basic Guide
+
+Pressing `F12` shows or hides the file selector. Use the cursor keys and `Enter` to load the selected file.
+
+[.text-center] 
+image:img/sms.png[pdfwidth=70%]
+
+<<<
+
 === Chip-8
 
 https://en.wikipedia.org/wiki/CHIP-8[CHIP-8] is an interpreted programming language, developed by Joseph Weisbecker. It was initially used on the COSMAC VIP and Telmac 1800 8-bit microcomputers in the mid-1970s. Erik Bryntse later created another interpreter based on CHIP-8, called SCHIP, S-CHIP or Super-Chip which extended the CHIP-8.
@@ -2335,7 +2515,8 @@ See the <<#_cores,corresponding section>> for instructions of how to install the
 
 During the core execution:
 
-- `Scroll Lock`: Change between RGB and VGA video mode
+- `Scroll Lock`: Change between RGB/Composite and VGA video mode
+- `F2`: Switch between RGB and Composite when not in VGA video mode
 - `F3`: Reset
 - `Ctrl+Alt+Backspace`: Hard reset
 - After loading a ROM, most games will prompt the user with "SELECT GAME". Press `0`-`9` on the keyboard or mapped controller button to play the game. 

doc/Manual de ZXUNO+.adoc

@@ -1,6 +1,6 @@
 = Manual de ZXUNO+
 :author: kounch
-:revnumber: 0.11
+:revnumber: 0.12
 :doctype: book
 :front-cover-image: image:img/portadauno.jpg[]
 :email: kounch@users.noreply.github.com
@@ -2005,6 +2005,7 @@ Durante la ejecución del core:
 
 - `F1` a `F4`: Modos Turbo
 - `F12`: Soft Reset
+- `Ctrl+Alt+F5`: NMI
 - `Ctrl+Alt+Supr`: Reset
 - `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima del enter
 
@@ -2222,6 +2223,100 @@ En él se pueden activar o desactivar las siguientes opciones:
 
 <<<
 
+=== Oric Atmos
+
+El https://es.wikipedia.org/wiki/Oric_Atmos[Oric Atmos] era un ordenador doméstico fabricado por Oric Products International Ltd , sucesor del Oric 1.
+
+La versión para ZX-Uno tiene las siguientes características:
+
+- Salida de vídeo VGA o RGB
+- NMI
+- DOS-8D (basado en el http://www.museo8bits.com/pravetz8d.htm[Pravetz 8d], clon búlgaro del Oric Atmos)
+
+Para más información consultar https://zxuno.com/forum/viewtopic.php?f=19&t=7[el foro oficial de ZX-Uno].
+
+==== Formato de Tarjeta SD
+
+La tarjeta SD ha de ser en un formato exclusivo, y por tanto no puede ser utilizada con otros cores. Está basada en imágenes de disco `NIB` concatenadas. Para convertir imágenes de disco en otro formato (`DSK`), se puede utilizar la utilidad `dsk2nib` (notar que tienen que ser imágenes de 232960 bytes de tamaño).
+
+[WARNING]
+====
+Este proceso borra el contenido que hubiera antes en la tarjeta SD, y no se puede deshacer.
+====
+
+===== Windows
+
+Concatenar las imágenes usando `COPY`:
+
+[source,shell]
+----
+COPY /B imagen1.nib + imagen2.nib + (...) + imagen20.nib oric_discos.img
+----
+
+Volcar la imagen en la SD, por ejemplo, usando http://hddguru.com/software/HDD-Raw-Copy-Tool/[HDD Raw Copy Tool].
+
+===== MacOS y Linux
+
+Concatenar las imágenes usando `cat`:
+
+[source,shell]
+----
+cat imagen1.nib imagen2.nib (...) imagen20.nib > oric_discos.img
+----
+
+Volcar la imagen en la SD, usando `dd`:
+
+[source,shell]
+----
+sudo umount /dev/...
+sudo dd if=oric_discos.img of=/dev/...
+----
+
+<<<
+
+==== Teclado
+
+La distribución del teclado está en inglés (así, por ejemplo, la tecla `-` se corresponde con `'`, al lado del número `0`).
+
+[.text-center] 
+image:img/keyboardoric.png[pdfwidth=80%]
+
+===== Teclas especiales y botones       
+
+Durante la ejecución del core:
+
+- `Bloq. Despl.`: para cambiar entre modo de vídeo RGB y VGA
+- `Inicio`: Mostrar datos de depuración (Pista de disco actual -dos dígitos-, número de imagen de disco -dos dígitos-, y registro de contador de programa -cuatro dígitos-)
+- `Fin`: NMI
+- `Inicio+Fin`: Reset 
+- `Re.Pag`: Seleccionar el siguiente disco
+- `Av.Pag`: Seleccionar el  disco anterior
+
+<<<
+
+==== Guía básica
+
+[.text-center] 
+image:img/oric.png[pdfwidth=70%]
+
+Se puede cargar DOS-8D con el comando:
+
+[source]
+----
+CALL800
+----
+
+Ahora, se puede ver el contenido del disco actual con el comando `DIR`.
+
+Para ejecutar un programa, se ha de escribir `-` delante del nombre. Así, por ejemplo, para un programa llamado `DEFENDER.EXE`:
+
+[source]
+----
+-DEFENDER.EXE
+----
+
+<<<
+
 === PC XT
 
 El core https://www.zxuno.com/forum/viewforum.php?f=56[Next186lite] es una implementación adaptada y recortada del core http://flea.vieju.net/?page_id=20[Next186] para FleaFPGA y Papilio Pro.
@@ -2246,6 +2341,91 @@ Si no estuviera ya, <<#_cores,instalar el core de PC XT>> en el ZXUNO+.
 
 <<<
 
+=== SAM Coupé
+
+El https://es.wikipedia.org/wiki/SAM_Coupé[SAM Coupé] fue un ordenador doméstico desarrollado y comercializado a partir de 1989 por Miles Gordon Technology, basado en el Sinclair ZX Spectrum.
+
+El core de ZX-Uno tiene las siguientes características:
+
+- Soporte VGA (con scanlines) y RGB / Video compuesto
+- Soporte de teclado completo
+- Sonido SAA1099
+- Carga desde dispositivos de audio externos
+
+==== Formato de Tarjeta SD
+
+Este core no utiliza la tarjeta SD.
+
+==== Teclado
+
+===== Teclas especiales y botones
+
+Durante la ejecución del core:
+
+- `Ctrl+Alt+F5`: NMI.
+- `Ctrl+Alt+Supr`: Soft reset.
+- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`.
+
+<<<
+
+==== Guía básica
+
+[.text-center] 
+image:img/samcoupe.png[pdfwidth=70%]
+
+Sólo es posible cargar programas desde una cinta (u <<#_miniduino,otro dispositivo externo de audio>>) con el comando `LOAD""` (o pulsando `7` del teclado numérico, equivalente a pulsar `F7` en el teclado del SAM Coupé).
+
+[TIP]
+====
+En el repositorio SVN de ZX-Uno (https://guest:zxuno@svn.zxuno.com/svn.zxuno.com/svn/zxuno/software/SamCoupe/[aquí] - Usuario `guest`, contraseña `zxuno`) se pueden encontrar varios programas adaptados a fichero de cinta TZX.
+====
+
+<<<
+
+=== Sega Master System
+
+La https://es.wikipedia.org/wiki/Master_System[Master System] fue una consola de videojuegos de 8 bits basada en cartuchos y tarjetas, desarrollada por Sega. 
+
+El core de ZX-Uno está basado en el http://forum.gadgetfactory.net/index.php?/topic/1304-sega-master-system-on-the-papilio-plus/[trabajo original de Ben para Papilio Plus].
+
+Algunas de sus características son:
+
+- Soporte para VGA y Video compuesto o RGB, con sincro PAL (50Hz)
+- Soporte de joysticks
+- Emulación de joystick vía teclado
+- Lectura de archivos desde la tarjeta SD
+
+==== Formato de Tarjeta SD
+
+Se debe de utilizar una tarjeta SD, con la primera partición en formato FAT16, para almacenar los ficheros con las imágenes (extensión `.SMS` o `.BIN`) de los juegos que se desee cargar. Los ficheros pueden estar en subdirectorios.
+
+Si no estuviera ya, <<#_cores,instalar el core de Sega Master System>> en el ZXUNO+.
+
+==== Teclado
+
+===== Teclas especiales y botones
+
+Durante la ejecución del core:
+
+- Cursor o `Q`, `A`, `O`, `P` o el joystick 1: Controles de dirección del jugador 1
+- `Z`, `Windows` o el botón de joystick 1: Botón de disparo 1 del jugador 1
+- `X`, `Espacio` o el botón secundario de joystick 1: Botón de disparo 2 del jugador 1
+- `Pause`: Tecla de botón de pausa de Master System
+- `Bloq. Despl.`: para cambiar entre modo de vídeo RGB/Vídeo Compuesto y VGA
+- `Ctrl+Alt+Backspace`: Hard reset.
+- `F12`: Reset y mostrar el selector de ficheros
+
+<<<
+
+==== Guía básica
+
+Pulsando `F12` se muestra el selector de archivos `SMS` o `BIN`. Para desplazarse por el menú y elegir el archivo a cargar, se utilizan las teclas de cursor y `Enter`.
+
+[.text-center] 
+image:img/sms.png[pdfwidth=70%]
+
+<<<
+
 === Chip-8
 
 https://es.wikipedia.org/wiki/CHIP-8[CHIP-8] es un lenguaje de programación interpretado, desarrollado por Joseph Weisbecker. Fue inicialmente usado en los microcomputadores de 8 bits COSMAC VIP y Telmac 1800 a mediados de 1970. CHIP-8 tiene un descendiente llamado SCHIP (Super Chip), presentado por Erik Bryntse.
@@ -2323,7 +2503,7 @@ La versión para ZXUNO+ está desarrollada por avlixa, basada en el core de ZXDO
 
 Algunas de las características del core son:
 
-- Dos modos de vídeo seleccionables: RGB y VGA
+- Dos modos de vídeo seleccionables: RGB/Video Compuesto y VGA
 - Necesita Joystick(s) para funcionar
 - Modos de color incluyendo monocromo o fósforo verde/naranja
 - Soporte para modificar el tipo de letra (charset) de la ROM de VDC
@@ -2340,7 +2520,8 @@ Si no estuviera ya, <<#_cores,instalar el core de Videopac>> en el ZXUNO+.
 
 Durante la ejecución del core:
 
-- `Bloq. Despl.`: para cambiar entre modo de vídeo RGB y VGA
+- `Bloq. Despl.`: para cambiar entre modo de vídeo RGB/Vídeo Compuesto y VGA
+- `F2`: Alternar entre RGB y vídeo compuesto cuando no se está usando el modo VGA
 - `F3`: Reset
 - `Ctrl+Alt+Backspace`: Hard reset.
 - Tras cargar una ROM, la mayoría de los juegos mostrarán un mensaje "SELECT GAME". Pulsar una tecla entre `0` y `9` o el botón del joystick para jugar.