diff --git a/doc/English ZXUNO+ Manual.adoc b/doc/English ZXUNO+ Manual.adoc index 6c6e2ac..0c29327 100644 --- a/doc/English ZXUNO+ Manual.adoc +++ b/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. diff --git a/doc/English ZXUNO+ Manual.pdf b/doc/English ZXUNO+ Manual.pdf index 9317156..82d40a6 100644 Binary files a/doc/English ZXUNO+ Manual.pdf and b/doc/English ZXUNO+ Manual.pdf differ diff --git a/doc/Manual de ZXUNO+.adoc b/doc/Manual de ZXUNO+.adoc index 661bb23..c022f0b 100644 --- a/doc/Manual de ZXUNO+.adoc +++ b/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. diff --git a/doc/Manual de ZXUNO+.pdf b/doc/Manual de ZXUNO+.pdf index 2b04329..f0358e3 100644 Binary files a/doc/Manual de ZXUNO+.pdf and b/doc/Manual de ZXUNO+.pdf differ diff --git a/doc/img/keyboardoric.png b/doc/img/keyboardoric.png new file mode 100644 index 0000000..73dcb01 Binary files /dev/null and b/doc/img/keyboardoric.png differ diff --git a/doc/img/oric.png b/doc/img/oric.png new file mode 100644 index 0000000..f8f083f Binary files /dev/null and b/doc/img/oric.png differ diff --git a/doc/img/samcoupe.png b/doc/img/samcoupe.png new file mode 100644 index 0000000..ec39fed Binary files /dev/null and b/doc/img/samcoupe.png differ diff --git a/doc/img/sms.png b/doc/img/sms.png new file mode 100644 index 0000000..22068f2 Binary files /dev/null and b/doc/img/sms.png differ