Merge pull request #51 from zxdos/master

sync with upstream
This commit is contained in:
Ivan Tatarinov 2021-05-15 13:08:21 +03:00 committed by GitHub
commit d5e10bde8d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
11 changed files with 354 additions and 13 deletions

Binary file not shown.

View File

@ -1,10 +1,10 @@
= ZXUNO+ Manual
:author: kounch
:revnumber: 0.13
:revnumber: 1.0.0
:doctype: book
:front-cover-image: image:img/portadauno.jpg[]
:email: kounch@users.noreply.github.com
:Revision: 0.11
:Revision: 1.0
:description: English ZXUNO+ Manual
:keywords: Manual, English, ZXUNO+
:icons: font
@ -1012,7 +1012,7 @@ Once downloaded and extracted, the contents of `BIN` and `SYS` directories have
Copy `ESXMMC.BIN` (or `ESXMMC.ROM`, depending on version) to the root of the SD card.
Start ZXUNO+ with the card inserted and press `F2` to access BIOS setup. Select the `Upgrade` menu and choose __"Upgrade esxdos for ZX"__. In the dialog that appears choose __"SD file"__ and, when it asks __"Load from SD"__ answer __"Yes"__ to the question __"Are you sure?"__. The content of the file `ESXDOS...` will be read, written to the flash storage and you will be notified when it is updated.
Start ZXUNO+ with the card inserted and press `F2` to access BIOS setup. Select the `Upgrade` menu and choose __"Upgrade esxdos for ZX"__. In the dialog that appears choose __"SD file"__ and, when it asks __"Load from SD"__ answer __"Yes"__ to the question __"Are you sure?"__. The content of the file `ESXMMC...` will be read, written to the flash storage and you will be notified when it is updated.
Do a Hard-reset, or turn it off and on.
@ -1169,17 +1169,22 @@ Main features:
==== SD card format
And SD card with the first partition in FAT16 or FAT32 format is needed to load software from it. A special ROM inside the core (Smart SPI)
An SD card with the first partition in FAT16 or FAT32 format is needed to load software from it. A special ROM inside the core (Smart SPI)
reads a special file with disk images inside.
The file must have the name `BEEB.MMB` and it has to be in the root directory. You can make one with `MMBImager` for Windows, available at https://guest:zxuno@svn.zxuno.com/svn/zxuno/cores/Acorn_electron/test1/varios/[ZX-Uno SVN Repository] (Usuario `guest`, contraseña `zxuno`) or with MMB/SSD Utils in perl, available at https://github.com/sweharris/MMB_Utils[GitHub].
The file has to be whole across the SD (not fragmented). You can use some any program that can defrag files or FAT filesystems or use the following method:
The file has to be whole across the SD (not fragmented). You can use a program that can defrag files or FAT filesystems (like https://www.ccleaner.com/defraggler[Defraggler for Windows]) or use the following method:
. Format the first SD partition using FAT16 or FAT32, but *NOT with quick format* (when using Windos, uncheck that option).
. Copy `BEEM.MB` making sure it is the *FIRST file* being copied.
. If you want you can add any other file to the SD (e.g. for using with other cores), but keep *ALWAYS* `BEEB.MMB` as the first file copied to the card.
[TIP]
====
Since the `MMB` file has the same name as the one for <<#_bbc_micro,BBC Micro core>>, you can use another core with full access to the SD card (like a a ZX Spectrum core with esxdos), with both `MMB` files with a different name, and then rename the one for Acorn Electron as `BEEB.MMB` before running this core
====
==== Keyboard
===== Special keys and buttons
@ -1212,7 +1217,7 @@ Disc 0 from the image file is mounted automatically, and you can see it's conten
*CAT
----
To load, for example, the mene available with some image files available on internet, use the command:
To load, for example, the menu available with some image files available on internet, use the command:
[source]
----
@ -1564,6 +1569,115 @@ The following options are available:
<<<
=== BBC Micro
The https://en.wikipedia.org/wiki/BBC_Micro[BBC Micro], was a series of microcomputers and associated peripherals designed and built by the Acorn Computer company in the 1980s for the BBC Computer Literacy Project, operated by the British Broadcasting Corporation.
The ZX-Uno core has been made by Quest y and enhanced after by azesmbog y hoglet.
Some of its features are:
- RGB and VGA (with optional scanlines) video output
- SD/MMC support, using `.MMB` files
- PS/2 keyboard
- Joystick support on port 1 (Emulating an analog joy)
- sn76489 sound chip implementation from https://github.com/wsoltys/pacedev[PACE project] (Programmable Arcade Circuit Emulation)
==== SD card format
An SD card with the first partition in FAT16 or FAT32 format is needed to load software. A special ROM inside the core (MMFS in the more recent core versions, Smart SPI on older ones) which reads a `BEEB.MMB` file with disk images inside.
The file must have the name `BEEB.MMB` and it has to be in the root directory. You can make one with `MMBImager` for Windows, available at https://guest:zxuno@svn.zxuno.com/svn/zxuno/cores/Acorn_electron/test1/varios/[ZX-Uno SVN Repository] (Usuario `guest`, contraseña `zxuno`) or with MMB/SSD Utils in perl, available at Github https://github.com/sweharris/MMB_Utils[here] or https://github.com/sweharris/MMB_Utils[here].
The file has to be whole across the SD (not fragmented). You can use a program that can defrag files or FAT filesystems (like https://www.ccleaner.com/defraggler[Defraggler for Windows]) or use the following method:
. Format the first SD partition using FAT16 or FAT32, but *NOT with quick format* (when using Windos, uncheck that option).
. Copy `BEEM.MB` making sure it is the *FIRST file* being copied.
. If you want you can add any other file to the SD (e.g. for using with other cores), but keep *ALWAYS* `BEEB.MMB` as the first file copied to the card.
[TIP]
====
Since the `MMB` file has the same name as the one for <<#_acorn_electron,Acorn Electron core>>, you can use another core with full access to the SD card (like a a ZX Spectrum core with esxdos), with both `MMB` files with a different name, and then rename the one for BBC Micro as `BEEB.MMB` before running this core
====
<<<
==== Keyboard
[.text-center]
image:img/keyboardbbc.png[pdfwidth=80%]
===== Special keys and buttons
While the core is running:
- `Scroll Lock`: change between RGB and VGA video mode
- `-` (numeric keyboard): Enable or disable scanlines in VGA mode
- `F12`: Reset
- `Shift+F12`: Soft Reset trying to load automatically the selected disk at `BEEB.MMB`
- `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/bbcmicro.png[pdfwidth=80%]
Once the SD card is inserted and the core running, if `BEEB.MMB` file was created correctly, on start, you should see:
[source]
----
BBC Computer 32k
Model B MMFS
BASIC
>
----
Or, for a core with Smart SPI
[source]
----
BBC Computer 32k
Smart SPI
BASIC
----
Disc 0 from the image file is mounted automatically, and you can see it's contents using the command:
[source]
----
*CAT
----
To load, for example, a file name `MENU`, use the command:
[source]
----
*MENU
----
To show the list of available discs inside `BEEB.MMB` file:
[source]
----
*DCAT
----
To load a particular virtual disc:
[source]
----
*DIN discnum
----
[TIP]
====
Remember that, after inserting a disc, if it has automatic boot, you can start it pressing `Shift+F12`.
====
<<<
=== 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.
@ -2555,6 +2669,63 @@ See the <<#_cores,corresponding section>> for instructions of how to install the
<<<
=== Vectrex
The https://en.wikipedia.org/wiki/Vectrex[Vectrex] was a vector display-based home video game console. It also had an integrated monochrome CRT monitor.
The ZX-Uno core is based on https://sourceforge.net/projects/darfpga/files/Software%20VHDL/vectrex/[DarFPGA`s original work].
Some of its features are:
- VGA video out
- OSD Menu
- Joystick and keyboard controles
- Maximum supported ROM size: 8K
==== SD card format
You need a SD card with the first partition in FAT16 or FAT32 format to store `BIN` or `VEC` files of the software to to load. Those files can be inside subdirectories.
At https://archive.org/details/GCE_Vectrex_TOSEC_2012_04_23[archive.org] you can obtain software for Vectrex.
See the <<#_cores,corresponding section>> for instructions of how to install the Vectrex core in ZXUNO+.
==== Keyboard
===== Special keys and buttons
During the core execution:
- Cursor or joystick: Directional controls
- `Z`: Fire button 1
- `X` or main joystick button: Fire button 2
- `C` or secondary joystick button: Fire button 3
- `V`: Fire button 4
- `Esc`: Show or hide the menu
- `Ctrl+Alt+Backspace`: Hard reset
- `F12`: Reset
<<<
==== Basic guide
By default, Vectrex starts with the built in game (Mine Storm).
[.text-center]
image:img/vectrex.png[pdfwidth=80%]
Pressing `Esc` shows or hides the configuration menu. Cursor keys and `Enter` are used to select and choose menu options.
The following options are available:
- Reset core
- Disable bluish color and enable white color for vectors
- Load ROM file from SD
- Exit the menu
<<<
=== Videopac
https://en.wikipedia.org/wiki/Magnavox_Odyssey_2[Philips Videopac], also known as Magnavox Odyssey², Philips Videopac G7000 o Philips Odyssey², is a second generation home video game console that was released in 1978.

Binary file not shown.

View File

@ -1,10 +1,10 @@
= Manual de ZXUNO+
:author: kounch
:revnumber: 0.13
:revnumber: 1.0.0
:doctype: book
:front-cover-image: image:img/portadauno.jpg[]
:email: kounch@users.noreply.github.com
:Revision: 0.11
:Revision: 1.0
:description: Manual en castellano de ZXUNO+
:keywords: Manual, Castellano, ZXUNO+
:icons: font
@ -1020,7 +1020,7 @@ Una vez descargado y descomprimido, se ha de copiar, a la raíz de la tarjeta, e
Copiar `ESXMMC.BIN` (o `ESXMMC.ROM`, según la versión) en la raíz de la tarjeta SD.
Iniciar el ZXUNO+ con la tarjeta insertada y pulsar F2 para acceder a la configuración de BIOS. Seleccionar el menú `Upgrade` y elegir __"Upgrade esxdos for ZX"__. En el diálogo que aparece elegir __"SD file"__ y, cuando pregunte __"Load from SD"__ contestar __"Yes"__ a la pregunta __"Are you sure?"__. Se leerá el contenido del fichero `ESXDOS...`, se grabará en la flash y avisará cuando esté actualizado.
Iniciar el ZXUNO+ con la tarjeta insertada y pulsar F2 para acceder a la configuración de BIOS. Seleccionar el menú `Upgrade` y elegir __"Upgrade esxdos for ZX"__. En el diálogo que aparece elegir __"SD file"__ y, cuando pregunte __"Load from SD"__ contestar __"Yes"__ a la pregunta __"Are you sure?"__. Se leerá el contenido del fichero `ESXMMC...`, se grabará en la flash y avisará cuando esté actualizado.
Realizar un Hard-reset, o apagar y encender.
@ -1197,12 +1197,17 @@ Se debe de utilizar una tarjeta SD con la primera partición en formato FAT16 o
El archivo debe llamarse `BEEB.MMB` y estar en el directorio raíz. Se puede crear con la utilidad `MMBImager` para Windows, disponible en https://guest:zxuno@svn.zxuno.com/svn/zxuno/cores/Acorn_electron/test1/varios/[el repositorio SVN de ZX-Uno] (Usuario `guest`, contraseña `zxuno`) o con la utilidades MMB/SSD en perl, disponibles en https://github.com/sweharris/MMB_Utils[GitHub].
El fichero debe estar sin fragmentar en la SD. Se puede utilizar algún programa que defragmente ficheros o sistemas de archivos FAT, o bien usar el siguiente método:
El fichero debe estar sin fragmentar en la SD. Se puede utilizar algún programa que defragmente ficheros o sistemas de archivos FAT (como https://www.ccleaner.com/defraggler[Defraggler para Windows]), o bien usar el siguiente método:
. Formatear la primera partición de la SD en FAT16 o FAT32, pero *NO en formato rápido* (en Windows, desmarcar la casilla de formato rápido).
. Copiar a la SD el archivo `BEEB.MMB`, de modo que este sea el *PRIMER archivo* que se copia a la SD.
. Si se desea, ya se pueden copiar otros archivos a la SD para usar con otros cores, pero *SIEMPRE debe mantenerse el `BEEB.MMB`* como el primero que se copió a la SD.
[TIP]
====
Como el fichero `MMB` se llama igual que el que utiliza el <<#_bbc_micro,core de BBC Micro>>, se puede usar otro core con acceso completo a la tarjeta SD (Como uno de ZX Spectrum con esxDOS), teniendo dos ficheros `MMB` distintos, y renombrar el de Acorn Electron como `BEEB.MMB` antes de ejecutar este core
====
==== Teclado
===== Teclas especiales y botones
@ -1573,6 +1578,115 @@ En él se pueden activar, desactivar o configurar las siguientes opciones:
<<<
=== BBC Micro
El https://es.wikipedia.org/wiki/BBC_Micro[BBC Micro], fue uno de los primeros ordenadores domésticos, diseñado y construido por Acorn Computers para la British Broadcasting Corporation (BBC).
El core para ZX-Uno ha sido creado por Quest y mejorado posteriormente por azesmbog y hoglet.
Algunas de sus características son:
- Salida vídeo RGB y VGA (con scanlines opcionales)
- Soporte SD/MMC, vía archivos de imagen `.MMB`
- Teclado PS/2 (mapeado a teclado inglés)
- Soporte de joystick en el puerto 1 (Emula Joy analógico)
- Implementación del chip de sonido sn76489 desde el https://github.com/wsoltys/pacedev[proyecto PACE] (Programmable Arcade Circuit Emulation)
==== Formato de Tarjeta SD
Se debe de utilizar una tarjeta SD con la primera partición en formato FAT16 o FAT32. El core usa una ROM especial (MMFS en los cores más recientes, Smart SPI en los más antiguos) que lee de la SD un archivo `BEEB.MMB`, que contiene imágenes de disquete.
El archivo debe llamarse exactamente `BEEB.MMB` y estar en el directorio raíz. Se puede crear con la utilidad `MMBImager` para Windows, disponible en https://guest:zxuno@svn.zxuno.com/svn/zxuno/cores/Acorn_electron/test1/varios/[el repositorio SVN de ZX-Uno] (Usuario `guest`, contraseña `zxuno`) o con la utilidades MMB/SSD en perl, disponibles en Github https://github.com/hoglet67/MMFS/tree/master/tools/mmb_utils[aquí] o https://github.com/sweharris/MMB_Utils[aquí].
El fichero `MMB` debe estar sin fragmentar en la SD. Se puede utilizar algún programa que defragmente ficheros o sistemas de archivos FAT (como https://www.ccleaner.com/defraggler[Defraggler para Windows]), o bien usar el siguiente método:
. Formatear la primera partición de la SD en FAT16 o FAT32, pero *NO en formato rápido* (en Windows, desmarcar la casilla de formato rápido).
. Copiar a la SD el archivo `BEEB.MMB`, de modo que este sea el *PRIMER archivo* que se copia a la SD.
. Si se desea, ya se pueden copiar otros archivos a la SD para usar con otros cores, pero *SIEMPRE debe mantenerse el `BEEB.MMB`* como el primero que se copió a la SD.
[TIP]
====
Como el fichero `MMB` se llama igual que el que utiliza el <<#_acorn_electron,core de Acorn Electron>>, se puede usar otro core con acceso completo a la tarjeta SD (Como uno de ZX Spectrum con esxDOS), teniendo dos ficheros `MMB` distintos, y renombrar el de BBC Micro como `BEEB.MMB` antes de ejecutar este core
====
<<<
==== Teclado
[.text-center]
image:img/keyboardbbc.png[pdfwidth=80%]
===== Teclas especiales y botones
Durante la ejecución del core:
- `Bloq. Despl.`: Cambia de modo video compuesto a VGA y viceversa.
- `-` (del teclado numérico): Activa o desactiva scanlines
- `F12`: Reset
- `Mayús+F12`: Soft Reset intentando cargar automáticamente el disco seleccionado en `BEEB.MMB`
- `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/bbcmicro.png[pdfwidth=80%]
Una vez introducida la SD en el ZX-UNO y arrancado el core, si el archivo de `BEEB.MMB` está correctamente creado, al arrancar debería aparecer:
[source]
----
BBC Computer 32k
Model B MMFS
BASIC
>
----
O bien, si es un core con Smart SPI
[source]
----
BBC Computer 32k
Smart SPI
BASIC
----
Automáticamente se monta el disco 0 de la imagen, y se puede ver su contenido con el comando:
[source]
----
*CAT
----
Para cargar, por ejemplo, un programa llamado `MENU`, y que esté en el disco usar el comando:
[source]
----
*MENU
----
Para ver una lista de los discos disponibles en el fichero `BEEB.MMB`:
[source]
----
*DCAT
----
Para insertar un disco concreto:
[source]
----
*DIN numerodisco
----
[TIP]
====
Recordar, tras insertar un disco, que si este tiene arranque automático, se puede iniciar pulsando `Mayús+F12`.
====
<<<
=== Camputers Lynx
@ -2548,7 +2662,7 @@ image:img/sms.png[pdfwidth=70%]
=== SmartROM
https://github.com/Utodev/smartROM[SmartROM] es un nuevo firmware para el core de Spectrum del ZX-UNO pensado para funcionar en placas FPGA que no tengan flash, o en las que no se pueda usar. Está basado en una versión del core de McLeod hay había hecho un core "sin flash", que contiene la ROM y ESXDOS dentro del propio core. El proyecto SmartROM incluye una versión ligeramente modificada de ese core, junto con un fichero que en la SD que permite cargar una ROM de Spectrum distinta y, además, cambiar algunos ajustes.
https://github.com/Utodev/smartROM[SmartROM] es un nuevo firmware para el core de Spectrum del ZX-UNO pensado para funcionar en placas FPGA que no tengan flash, o en las que no se pueda usar. Está basado en una versión del core de McLeod hay había hecho un core "sin flash", que contiene la ROM y esxdos dentro del propio core. El proyecto SmartROM incluye una versión ligeramente modificada de ese core, junto con un fichero que en la SD que permite cargar una ROM de Spectrum distinta y, además, cambiar algunos ajustes.
==== Formato de Tarjeta SD
@ -2562,6 +2676,62 @@ Si no estuviera ya, <<#_cores,instalar el core smartROM>> en el ZXUNO+.
<<<
=== Vectrex
La https://es.wikipedia.org/wiki/Vectrex[Vectrex] era una consola con pantalla integrada y con los gráficos basados en vectores, en vez de píxeles.
El core para ZX-Uno está basado en el https://sourceforge.net/projects/darfpga/files/Software%20VHDL/vectrex/[trabajo original de DarFPGA].
Algunas de sus características son:
- Soporte VGA
- Menú OSD
- Controles vía teclado y vía joystick
- Tamaño máximo de la ROM a cargar: 8K
==== Formato de Tarjeta SD
Se debe de utilizar una tarjeta SD, con la primera partición en formato FAT16 o FAT32, para almacenar los ficheros con las imágenes (extensión `.BIN` o `.VEC`) de los juegos que se desee cargar. Los ficheros pueden estar en subdirectorios.
En https://archive.org/details/GCE_Vectrex_TOSEC_2012_04_23[archive.org] se puede obtener software para Vectrex.
Si no estuviera ya, <<#_cores,instalar el core de Vectrex>> en el ZXUNO+.
==== Teclado
===== Teclas especiales y botones
Durante la ejecución del core:
- Cursor o el joystick 1: Controles de dirección
- `Z`: Botón de disparo 1
- `X` o el botón principal de joystick: Botón de disparo 2
- `C` o el botón secundario de joystick: Botón de disparo 3
- `V`: Botón de disparo 4
- `Esc`: para mostrar u ocultar el menú.
- `Ctrl+Alt+Backspace`: Hard reset.
- `F12`: Reset
<<<
==== Guía básica
Por defecto la Vectrex arranca con el juego que trae en memoria de fábrica (Mine Storm).
[.text-center]
image:img/vectrex.png[pdfwidth=80%]
Pulsando `Esc` se muestra el menú de configuración. Se usan las teclas de cursor y `Enter` para elegir y seleccionar en el menú.
En él se pueden activar, desactivar o configurar las siguientes opciones:
- Reiniciar el core (Reset)
- Utilizar blanco neutro para los vectores (Disable bluish vectors)
- Cargar un fichero desde la SD (Load ROM)
- Salir del menú (Exit)
<<<
=== Videopac
La https://es.wikipedia.org/wiki/Magnavox_Odyssey²[Philips Videopac], también conocida como Magnavox Odyssey², Philips Videopac G7000 o Philips Odyssey² es una videoconsola lanzada en 1978.

Binary file not shown.

BIN
doc/img/bbcmicro.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB

BIN
doc/img/keyboardbbc.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 298 KiB

BIN
doc/img/vectrex.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 436 KiB

Binary file not shown.

View File

@ -1,10 +1,10 @@
# Authors
2021 Ivan Tatarinov <ivan-tat@ya.ru>
2021 Antonio Villena
# Contributors
No one yet.
2021 Ivan Tatarinov <ivan-tat@ya.ru> (Makefile)
# License