diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.adoc b/doc/English ZXDOS+ and gomaDOS+ Manual.adoc index e0d9ff7..44f14a6 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.6.0 +:revnumber: 1.6.1 :doctype: book :notitle: :front-cover-image: image:img/portada.jpg[] @@ -581,7 +581,7 @@ image:./img/keyboardAV.png[pdfwidth=70%] ==== Special keys and buttons -The following gomaDOS+ key combinations are in `ZX` keyboard mode. Please check <<#_gomados_keyboard_modes,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations (like `Caps Shift+Symbol Shift+2` instead of `Caps Shift+1`). +The following gomaDOS+ key combinations are in `ZX` keyboard mode. Please check <<#_gomados_keyboard,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations (like `Caps Shift+Symbol Shift+2` instead of `Caps Shift+1`). Special keys which can be used during startup: @@ -700,7 +700,7 @@ The second screen shows the installed ZX Spectrum ROMs. You can reorder (Move Up [.text-center] image:img/bios3.png[pdfwidth=70%] -_Upgrade_ screen is used to perform the different updates of the Flash memory content: esxdos, BIOS, Cores, etc. (see <<#_updates,the section corresponding to updates>> for more information). +_Upgrade_ screen is used to perform the different updates of the Flash memory content: esxdos, BIOS, Cores, etc. (see <<#_upgrade,the section corresponding to upgrades>> for more information). <<< @@ -1333,6 +1333,11 @@ For example: .iwconfig mywifi mypassword ---- +[CAUTION] +==== +Since the selected VGA frequency affects the master clock frequency, for the communication between the core and the Wi-Fi module to work correctly, it has to be set at 50 (see the <<#_advanced,BIOS settings chapter>>). +==== + ==== Network tools for ZX-Uno pack These are programs, developed by Nihirash and that are available to https://nihirash.net/network-tools-for-zx-uno-pack/[download] https://nihirash.net/ugophy-1-0-and-nettools-for-zx-spectrum/#more-71[from his web]. @@ -1618,6 +1623,8 @@ The ZX Spectrum core update is exactly the same as other cores, but instead of t Due to some limitations in the FPGA, the cores that are stored in the SPI Flash second half have to be installed without using the space https://github.com/zxdos/zxuno/blob/master/firmware/formato_lx25.txt[at address `0x10B0000`]. https://github.com/zxdos/zxuno/blob/master/firmware/CORE21_special.ZXD[A special core] has to be there, this makes sure that, when another core installed in the upper half of the flash is reset, the main Spectrum core and the BIOS load correctly. ==== +<<< + === esxdos To update esxdos to a new version, the distribution must be obtained from https://www.esxdos.org[the official website]. @@ -1758,7 +1765,7 @@ If it wasn't already, <<#_cores,install ZX Spectrum Next core>> into ZXDOS+. ===== Special keys and buttons -The following gomaDOS+ key combinations are in `ZX` keyboard mode. Please check <<#_gomados_keyboard_modes,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations . +The following gomaDOS+ key combinations are in `ZX` keyboard mode. Please check <<#_gomados_keyboard,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations . Take into account that `Ctrl+Alt+backspace` does not work with the ZX Spectrum Next core. You have to power cycle if you want to use another core. Also, there is no Reset or Drive button. @@ -1878,7 +1885,7 @@ If it wasn't already, <<#_cores,install MSX core>> into ZXDOS+. ===== Special keys and buttons -The following gomaDOS+ key combinations are in `MSX` keyboard mode. Please check <<#_gomados_keyboard_modes,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations . +The following gomaDOS+ key combinations are in `MSX` keyboard mode. Please check <<#_gomados_keyboard,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations . While running the core: @@ -1985,7 +1992,7 @@ Copy all `ROM` and `DSK` files to the root directory of the FAT32 partition. ===== Special keys and buttons -The following gomaDOS+ key combinations are in `Amstrad CPC` keyboard mode. Please check <<#_gomados_keyboard_modes,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations. +The following gomaDOS+ key combinations are in `Amstrad CPC` keyboard mode. Please check <<#_gomados_keyboard,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations. During core execution: @@ -2055,7 +2062,7 @@ You can set up the files in the microSD in two different ways: ===== Special keys and buttons -The following gomaDOS+ key combinations are in `Acorn Electron` keyboard mode. Please check <<#_gomados_keyboard_modes,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations. +The following gomaDOS+ key combinations are in `Acorn Electron` keyboard mode. Please check <<#_gomados_keyboard,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations. While the core is running: @@ -2103,7 +2110,7 @@ See the <<#_cores,corresponding section>> for instructions of how to install the ===== Special keys and buttons -The following gomaDOS+ key combinations are in `Commodore 64` keyboard mode. Please check <<#_gomados_keyboard_modes,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations. +The following gomaDOS+ key combinations are in `Commodore 64` keyboard mode. Please check <<#_gomados_keyboard,the corresponding section>> for more information. You can also use `PC XT` keyboard mode combinations. While the core is running: @@ -2193,7 +2200,7 @@ Some features of this core are: - Two different video modes: RGB/PAL60Hz and VGA 60Hz - 7 game variants - Support for 2 or 4 players -- Support for Joysticks, keyboard, mouse and rotary encoder controls (see <<#_rotary_enoders,here>> for more information) +- Support for Joysticks, keyboard, mouse and rotary encoder controls (see <<#_rotary_encoders,here>> for more information) - Several colour modes ==== microSD format @@ -2321,7 +2328,7 @@ While running the core: - `F6` (`Caps Shift+Symbol Shift+6` on gomaDOS+): Switch between 48kB mode and 96kB mode (default) - `F7` (`Caps Shift+Symbol Shift+7` on gomaDOS+): Enable or disable Scorpio ROM - `F8` (`Caps Shift+Symbol Shift+8` on gomaDOS+): Switch the option to consider port $80 bits 2 and 3, so that Level 9 games are displayed properly. -- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` on gomaDOS+): Switch between RGB and VGA video output +- `SCroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): Switch between RGB and VGA video output - `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+B` on gomaDOS+): Reset - `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on gomaDOS+): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. @@ -2353,7 +2360,7 @@ Binary files are loaded with `MLOAD` instead of `LOAD`. Maxduino, which is used in <<#_miniduino,miniduino>> does not, at this moment, native support for Lynx tape files. ==== -You can use programs like <<#_audio_file_conversion,Lynx2Wav>> with Lynx `TAP` files. The resulting audio files can be embedded inside of TSX or TZX with tools like <<#_creación_de_ficheros_tzx_o_tsx_desde_otros_formatos,MakeTSX or RetroConverter>>. +You can use programs like <<#_audio_file_conversion,Lynx2Wav>> with Lynx `TAP` files. The resulting audio files can be embedded inside of TSX or TZX with tools like <<#_making_tzx_or_tsx_files_from_other_formats,MakeTSX or RetroConverter>>. The http://retrowiki.es/viewtopic.php?f=31&t=200036835[lince] script makes all this process easier, creating directly Maxduino `TZX` compatible files from Lynx `TAP` files. @@ -2415,7 +2422,7 @@ ZXDOS+ core version is developed by avlixa. Some of the features of the core are: - RGB and VGA support -- Support for joysticks, keyboard, mouse and rotary encoder controls (see <<#_rotary_enoders,here>> for more information) +- Support for joysticks, keyboard, mouse and rotary encoder controls (see <<#_rotary_encoders,here>> for more information) ==== microSD card format @@ -2552,14 +2559,32 @@ Those files can be made following the instructions and using the editor availabl The https://en.wikipedia.org/wiki/ZX81[ZX81] was a home computer produced by Sinclair Research,designed to be a low-cost introduction to home computing for the general public. -The ZXDOS+ version has been made by avlixa. +The ZXDOS+ version has been made by avlixa, based on Grant Searle's ZX80 page. + +Features: + +- Selectable ZX80/ZX81 (ZX80 currently working only in RGB mode) +- 16k/32k/48k RAM packs +- 8KB with CHR$128/UDG addon (not tested) +- QS CHRS (not tested) +- CHROMA81 +- Turbo in Slow mode: NoWait, x2, x8 +- YM2149 sound chip (ZON X-81 compatible) +- Joystick types: Cursor, Sinclar, ZX81, ZXpand +- PAL/NTSC timings +- Turbo loading of .o and .p files (.o files not working, .p files: partially working) +- Load alternative ROM. ==== microSD card format -You can use a microSD card with the first partition in FAT16 or FAT32 format to store tape files. +You can use a microSD card with the first partition in FAT16 or FAT32 format to store ROM and tape files. + +You have to copy the file `ZX8X.ROM` (available at the https://github.com/avlixa/ZX81_MiSTer_zxdos/raw/master/roms/zx8x.rom[official repository] into folder `/zx81/roms`: it is a concatenation of ZX81 rom (8k) + ZX80 rom (4k). See the <<#_cores,corresponding section>> for instructions of how to install the ZX81 core in ZXDOS+. +<<< + ==== Keyboard The PS/2 keyboard isn't mapped and the original machine keys layout is kept. For example, to obtain a `"` you have to type `Shift+P` or `Shift+0` to delete. @@ -2567,21 +2592,15 @@ The PS/2 keyboard isn't mapped and the original machine keys layout is kept. For [.text-center] image:img/keyboardZX81.jpg[pdfwidth=90%] -<<< - ===== Special keys and buttons During the core execution: -- `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): change between RGB and VGA video mode -- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on gomaDOS+): Hard reset - `Esc` or joystick button 2 (or `Caps Shift+Space` on gomaDOS+, `PC XT` keyboard mode): Show or hide configuration menu -- `F1` (`Caps Shift+Symbol Shift+1` on gomaDOS+): Assign emulated keys to joystick 1 (Default: `5`, `6`, `7`, `8` and `0`) -- `F2` (`Caps Shift+Symbol Shift+2` on gomaDOS+): Assign emulated keys to joystick 2 (Default: `Q`, `A`, `O`, `P` and `Space`) -- `F5` (`Caps Shift+Symbol Shift+5` on gomaDOS+): Starts playing a tape file previously loaded -- `F6` (`Caps Shift+Symbol Shift+6` on gomaDOS+): Stops playing the tape -- `F7` (`Caps Shift+Symbol Shift+7` on gomaDOS+): Ejects the tape (resets the info about the latest loaded file) -- `F12` (`Caps Shift+Symbol Shift+W` on gomaDOS+): Reset +- `F1` (`Caps Shift+Symbol Shift+1` on gomaDOS+): Enable or disable the alternative chars +- `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): Switch between RGB and VGA video output +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+B` on gomaDOS+): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on gomaDOS+): Hard reset <<< @@ -2595,17 +2614,50 @@ image:img/zx81.jpg[pdfwidth=70%] The following options are available: - Reset -- Double OSD Window - Load Tape +- Load ROM +- Configuration Options - Exit -You can load a tape file (previously selected from the menu) with the command `LOAD""` and then press `F5` (`Caps Shift+Symbol Shift+5` on gomaDOS+) to start the tape. Take note, that, while loading, the video output is disables and, unlike the original machine, you can hear the loading sound. +<<< + +[.text-center] +image:img/zx81_2.jpg[pdfwidth=70%] + +- Computer Model: ZX80/ZX81 +- Main RAM: 16K/32K +- Low RAM: Off/8KB +- Joystick: Cursor/Sinclair/ZX81 +- QS CHRS: Disabled/Enabled +- CHR$128/UDG: 128 chars/64 chars/Disabled +- Chroma81: Disabled/Enabled +- Inverse Video: Off/On +- Black Border: Off/On +- Slow mode speed: Original/No Wait/x2 +- Video frequency: 50Hz/60Hz + +You can load a tape file selecting it from the menu, then enter the command `LOAD""` and `Enter` [TIP] ==== Some monitors stop playing audio if the video signal is lost. It's recommended to plug headphones or a external speaker if you want to hear the sound while loading a tape. On a gomaDOS+, the internal speaker will play the sound if nothing is connected to the audio out port. ==== +`.p` files with colorization and char are supported. + +For colorization to work, CHROMA81 should be enabled before loading. For alternate chars, QS CHRS should be enabled before loading. + +[TIP] +==== +The recommended options for most games are: + +Main RAM: 16KB +Low RAM: 8KB +CHR$128: 128 chars +QS CHRS: enabled +CHROMA81: enabled +==== + <<< === PC XT diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.epub b/doc/English ZXDOS+ and gomaDOS+ Manual.epub new file mode 100644 index 0000000..ed43f2b Binary files /dev/null and b/doc/English ZXDOS+ and gomaDOS+ Manual.epub differ diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.pdf b/doc/English ZXDOS+ and gomaDOS+ Manual.pdf index 91e15d3..bf1077e 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 8a53e02..8688404 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.6.0 +:revnumber: 1.6.1 :doctype: book :notitle: :front-cover-image: image:img/portada.jpg[] @@ -582,7 +582,7 @@ image:./img/keyboardAV.png[pdfwidth=70%] ==== Teclas especiales y botones -Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `ZX`. Véase el <<#_modos_de_teclado_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT` (Por ejemplo, `Caps Shift+Symbol Shift+2` en vez de `Caps Shift+1`). +Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `ZX`. Véase el <<#_teclado_de_membrana_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT` (Por ejemplo, `Caps Shift+Symbol Shift+2` en vez de `Caps Shift+1`). Teclas especiales durante el arranque: @@ -596,7 +596,7 @@ Teclas especiales durante el arranque: Teclas especiales que se pueden utilizar durante la ejecución del core principal (ZX Spectrum): - `Esc` (`Caps Shift+Espacio` en gomaDOS+): BREAK -- `F1`: (`Caps Shift+Symbol Shift+1` en gomaDOS+): En las versiones más recientes del core, activar los distintos modos de color monocromo +- `F1` (`Caps Shift+Symbol Shift+1` en gomaDOS+): En las versiones más recientes del core, activar los distintos modos de color monocromo - `F2` (`Caps Shift+1` en gomaDOS+): Edit - `F5` (`Caps Shift+Symbol Shift+5` en gomaDOS+): NMI - `F7` (`Caps Shift+Symbol Shift+7` en gomaDOS+): Reproducir o Pausa en la reproducción de archivos .PZX @@ -648,7 +648,7 @@ Es recomendable, además, añadir los comandos esxdos específicos para ZXDOS+. zxuc zxunocfg -<<#_comandos_para_zxdos+,Más adelante>> se explica lo que hace cada uno de ellos. +<<#_comandos_para_zxdos,Más adelante>> se explica lo que hace cada uno de ellos. <<< @@ -1341,6 +1341,13 @@ Por ejemplo: .iwconfig miwifi miclavedeacceso ---- +[CAUTION] +==== +Debido a que la la frecuencia seleccionada para VGA afecta a la frecuencia del reloj maestro, para que el módulo Wi-Fi se comunique correctamente con el core, esta debe estar configurada a 50 (véase el <<#_advanced,apartado dedicado a la configuración de la BIOS>>). +==== + +<<< + ==== Network tools for ZX-Uno pack Se trata de un conjunto de programas, desarrollados por Nihirash y que se pueden https://nihirash.net/network-tools-for-zx-uno-pack/[descargar] https://nihirash.net/ugophy-1-0-and-nettools-for-zx-spectrum/#more-71[de su web]. @@ -1761,7 +1768,7 @@ Si no estuviera ya, <<#_cores,instalar el core de ZX Spectrum Next>> en el ZXDOS ===== Teclas especiales y botones -Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `ZX`. Véase el <<#_modos_de_teclado_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT`. +Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `ZX`. Véase el <<#_teclado_de_membrana_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT`. Notar que `Ctrl+Alt+backspace` no funciona con el core de Spectrum Next. Hay que apagar manualmente y volver a encender si se desea cambiar a otro core. Tampoco hay botón físico de Reset o Drive. @@ -1774,7 +1781,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 -- `F11`: (`Caps Shift+Symbol Shift+Q` en gomaDOS+): En las versiones más recientes del core, activar distintos modos de color monocromo +- `F11` (`Caps Shift+Symbol Shift+Q` en gomaDOS+): En las versiones más recientes del core, activar distintos modos de color monocromo - `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. <<< @@ -1881,7 +1888,7 @@ Si no estuviera ya, <<#_cores,instalar el core de MSX>> en el ZXDOS+. ===== Teclas especiales y botones -Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `MSX`. Véase el <<#_modos_de_teclado_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT`. +Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `MSX`. Véase el <<#_teclado_de_membrana_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT`. Durante la ejecución del core: @@ -1988,7 +1995,7 @@ Copiar tanto los ficheros `ROM` como los `DSK` a la raíz de la partición FAT32 ===== Teclas especiales y botones -Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `Amstrad CPC`. Véase el <<#_modos_de_teclado_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT`. +Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `Amstrad CPC`. Véase el <<#_teclado_de_membrana_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT`. Durante la ejecución del core: @@ -2058,7 +2065,7 @@ Ahora, se puede organizar la información en la tarjeta microSD de dos maneras d ===== Teclas especiales y botones -Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `Acorn Electron`. Véase el <<#_modos_de_teclado_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT`. +Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `Acorn Electron`. Véase el <<#_teclado_de_membrana_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de teclado `PC XT`. Durante la ejecución del core: @@ -2106,7 +2113,7 @@ Si no estuviera ya, <<#_cores,instalar el core de Commodore 64>> en el ZXDOS+. ===== Teclas especiales y botones -Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `Commodore 64`. Véase el <<#_modos_de_teclado_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de tecldo `PC XT`. +Las combinaciones específicas de gomaDOS+ que se indican a continuación se corresponden con el modo de teclado `Commodore 64`. Véase el <<#_teclado_de_membrana_en_gomados,apartado dedicado a los modos de teclado>> de gomaDOS+ para más información. También se pueden utilizar las equivalentes en el modo de tecldo `PC XT`. Durante la ejecución del core: @@ -2553,11 +2560,31 @@ Estos archivos se pueden crear siguiendo las instrucciones y utilizando el edito El computador personal https://es.wikipedia.org/wiki/ZX81[Sinclair ZX81], lanzado por Sinclair Research en 1981, fue el de menor precio de la época. -La versión para ZXDOS+ ha sido creada por avlixa. +La versión para ZXDOS+ ha sido creada por avlixa, basada en la página de Grant Searle's sobre el ZX80 + +Características: + +- Se puede elegir entre ZX80 y ZX81 (ZX80 sólo con salida RGB por el momento) +- 16k/32k/48k RAM packs +- 8KB con addon CHR$128/UDG (sin probar) +- QS CHRS (sin probar) +- CHROMA81 +- Turbo en modo lento: NoWait, x2, x8 +- Chip de sonido YM2149 (compatible con ZON X-81) +- Múltiples joysticks (Cursor, Sinclar, ZX81, ZXpand) +- Timings PAL y NTSC +- Turbo carga de ficheros .o y .p (.o no funcionan por el momento, .p funcionan parcialmente) +- Carga de ROM alternativa. ==== Formato de Tarjeta microSD -Se debe de utilizar una tarjeta microSD, con la primera partición en formato FAT16 o FAT32, para almacenar los ficheros con archivos de cinta que se deseen cargar. +Se debe de utilizar una tarjeta microSD, con la primera partición en formato FAT16 o FAT32, para almacenar los ficheros con archivos de cinta o ROM que se deseen cargar. + +SE ha de copiar el fichero `ZX8X.ROM` (disponible the https://github.com/avlixa/ZX81_MiSTer_zxdos/raw/master/roms/zx8x.rom[repositorio oficial] en el directorio `/zx81/roms`: se trata de los ficheros ZX81 rom (8k) + ZX80 rom (4k) concatenados. + +Si no estuviera ya, <<#_cores,instalar el core de ZX81>> en el ZXDOS+. + +<<< ==== Teclado @@ -2566,21 +2593,15 @@ El teclado no está mapeado a la distribución PS/2 estándar, y mantiene la dis [.text-center] image:img/keyboardZX81.jpg[pdfwidth=90%] -<<< - ===== Teclas especiales y botones Durante la ejecución del core: -- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de vídeo RGB y VGA -- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en gomaDOS+): Hard reset. - `Esc` o el botón 2 del joystick (o `Caps Shift+Espacio` en gomaDOS+) para mostrar u ocultar el menú. -- `F1` (`Caps Shift+Symbol Shift+1` en gomaDOS+): Asignar teclas simuladas al joystick 1 (por defecto: `5`, `6`, `7`, `8` y `0`) -- `F2` (`Caps Shift+Symbol Shift+2` en gomaDOS+): Asignar teclas simuladas al joystick 2 (por defecto: `Q`, `A`, `O`, `P` y `Espacio`) -- `F5` (`Caps Shift+Symbol Shift+5` en gomaDOS+): Inicia la reproducción de un archivo de cinta cargado -- `F6` (`Caps Shift+Symbol Shift+6` en gomaDOS+): Detiene la reproducción de cinta -- `F7` (`Caps Shift+Symbol Shift+7` en gomaDOS+): Desconecta la cinta (se olvida del último fichero cargado) -- `F12` (`Caps Shift+Symbol Shift+W` en gomaDOS+): Reset +- `F1` (`Caps Shift+Symbol Shift+1` en gomaDOS+): Habilitar o deshabilitar los caracteres alternativos +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de vídeo RGB y VGA +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+B` en gomaDOS+): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en gomaDOS+): Hard reset. <<< @@ -2594,17 +2615,50 @@ image:img/zx81.jpg[pdfwidth=70%] En él se pueden activar, desactivar o configurar las siguientes opciones: - Reiniciar el core (Reset) -- Duplicar el tamaño de la ventana de menú (Double OSD Window) - Cargar un archivo de cinta (Load Tape) +- Cargar una ROM alternativa (Load ROM) +- Configurar opciones (Configuration Options) - Salir del menú (Exit) -Desde BASIC, se puede cargar desde un fichero cinta, que se haya seleccionado desde el menú, con el comando `LOAD""` y pulsando a continuación `F5` (`Caps Shift+Symbol Shift+5` en gomaDOS+). Notar que, durante la carga, se desactiva la señal de vídeo y, al contrario que en la máquina original, se puede escuchar el audio de la cinta. +<<< + +[.text-center] +image:img/zx81_2.jpg[pdfwidth=70%] + +- Elegir el modelo de computador (Computer Model): ZX80/ZX81 +- Tamaño de RAM (Main RAM): 16K/32K +- RAM baja (Low RAM): Off/8KB +- Joystick: Cursor/Sinclair/ZX81 +- Habilitar o deshabilitar QS CHRS +- Configuración de CHR$128/UDG: 128 chars/64 chars/Disabled +- Habilitar o deshabilitar Chroma81: Disabled/Enabled +- Vídeo inverso (Inverse Video): Off/On +- Borde negro (Black Border): Off/On +- Modo de velocidad (Slow mode speed): Original/No Wait/x2 +- Frecuencia de vídeo (Video frequency): 50Hz/60Hz + +Desde BASIC, se puede cargar desde un fichero cinta, que se haya seleccionado desde el menú, con el comando `LOAD""` y pulsando `Enter`. [TIP] ==== Algunos monitores dejan de reproducir la entrada de audio si se desactiva la señal de vídeo. Se recomienda conectar unos auriculares o altavoces externos para poder oir el sonido durante la carga de una cinta. ==== +Se pueden cargar archivos `.p` con color y caracteres alternativos. + +Para que funcione el coloreado, se debe activar CHROMA81 antes de la carga. Igualmente, para los caracteres alternativos, QS CHRS debería estar activo antes de cargar. + +[TIP] +==== +Las opciones recomendadas para la mayoría de los juegos son: + +Main RAM: 16KB +Low RAM: 8KB +CHR$128: 128 chars +QS CHRS: enabled +CHROMA81: enabled +==== + <<< === PC XT @@ -2622,6 +2676,8 @@ Características del sistema implementado: - Soporte para teclado y raton PS/2 - Detección de BIOS en la tarjeta microSD en los primeros 64 sectores o en los últimos 16 +<<< + ==== Formato de Tarjeta microSD Se debe de utilizar una tarjeta SDHC (por tanto de al menos 4GB), con la primera partición FAT16 y con MS-DOS (o similar) instalado. Esto se puede conseguir usando, por ejemplo, software de virtualización y conectando directamente el dispositivo de la tarjeta microSD como disco. En los foros de https://www.zxuno.com/forum/viewforum.php?f=56[ZX-Uno] y https://www.forofpga.es/viewtopic.php?f=37&t=120[ZXDOS+] se puede obtener más información y encontrar algunas imágenes de tarjeta microSD. diff --git a/doc/Manual de ZXDOS+ y gomaDOS+.epub b/doc/Manual de ZXDOS+ y gomaDOS+.epub new file mode 100644 index 0000000..106ab29 Binary files /dev/null and b/doc/Manual de ZXDOS+ y gomaDOS+.epub differ diff --git a/doc/Manual de ZXDOS+ y gomaDOS+.pdf b/doc/Manual de ZXDOS+ y gomaDOS+.pdf index f22fd85..e6ec7dd 100644 Binary files a/doc/Manual de ZXDOS+ y gomaDOS+.pdf and b/doc/Manual de ZXDOS+ y gomaDOS+.pdf differ diff --git a/doc/img/zx81.jpg b/doc/img/zx81.jpg index 87394c8..41a5676 100644 Binary files a/doc/img/zx81.jpg and b/doc/img/zx81.jpg differ diff --git a/doc/img/zx81_2.jpg b/doc/img/zx81_2.jpg new file mode 100644 index 0000000..4332eba Binary files /dev/null and b/doc/img/zx81_2.jpg differ diff --git a/doc/miniduino_en.adoc b/doc/miniduino_en.adoc index 522a202..551d73c 100644 --- a/doc/miniduino_en.adoc +++ b/doc/miniduino_en.adoc @@ -186,7 +186,7 @@ Once you have the environment ready, download the software from the https://gith Miniduino player with STM32 microcontroller is only supported from 1.65 and up ==== -Load the project file with Arduino IDE (for example `MaxDuino_v1.66.ino`). +Load the project file with Arduino IDE (for example `MaxDuino_v1.69.ino`). Check in the file `userSTM32Config.h` that all logo entries are commented except for Miniduino and, if not, change them. @@ -245,7 +245,7 @@ You have to install SDFat (1.1.4) software library selecting the menu option Pro Once you have the environment ready, download the software from the https://github.com/rcmolina/MaxDuino_BETA[official repository in GitHub] -Load the project file with Arduino IDE (for example `MaxDuino_v1.68.ino`). +Load the project file with Arduino IDE (for example `MaxDuino_v1.69.ino`). Check in the file `userconfig.h` that all logo entries are commented except for Miniduino and, if not, change them. diff --git a/doc/miniduino_es.adoc b/doc/miniduino_es.adoc index 41ee8f3..1ba9a7b 100644 --- a/doc/miniduino_es.adoc +++ b/doc/miniduino_es.adoc @@ -192,7 +192,7 @@ Una vez preparado el entorno, descargar la versión deseada del proyecto desde e El reproductor Miniduino con microcontrolador STM32 sólo está soportado a partir de la versión 1.65 ==== -Cargar el fichero del proyecto en Arduino IDE (por ejemplo `MaxDuino_v1.66.ino`). +Cargar el fichero del proyecto en Arduino IDE (por ejemplo `MaxDuino_v1.69.ino`). Verificar en el fichero `userSTM32Config.h` que están comentadas todas las entradas de logo excepto la de Miniduino, y si no, cambiarlas. @@ -248,7 +248,7 @@ Una vez instalado Arduino IDE, se ha de añadir la biblioteca de software SDFat Una vez preparado el entorno, descargar la versión deseada del proyecto desde el https://github.com/rcmolina/MaxDuino_BETA[repositorio oficial en GitHub] -Cargar el fichero del proyecto en Arduino IDE (por ejemplo `MaxDuino_v1.68.ino`). +Cargar el fichero del proyecto en Arduino IDE (por ejemplo `MaxDuino_v1.69.ino`). Verificar en el fichero `userconfig.h` que estén comentadas todas las entradas de logo excepto la de Miniduino, y si no, cambiarlas.