diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.adoc b/doc/English ZXDOS+ and gomaDOS+ Manual.adoc index e577af5..07e4e56 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.3.1 +:revnumber: 1.3.2 :doctype: book :front-cover-image: image:img/portada.jpg[] :email: kounch@users.noreply.github.com @@ -826,7 +826,7 @@ Special keys which can be used during startup: - `Caps Lock` or `Cursor down` (`Caps Shift+2 on gomaDOS+): Core selection menu - `Esc` (`Caps Shift+Space` on gomaDOS+): ZX Spectrum core ROM selection menu - `R`: Loads the Spectrum core ROM in "real" mode, disabling esxdos, new graphics modes, etc. -- `/` (numeric keyboard): Load the default ZX Spectrum core ROM in "root" mode +- `/` (numeric keyboard, `Symbol Shift+V` on gomaDOS+): Load the default ZX Spectrum core ROM in "root" mode - Number from `1` to `9`: Load the core in the flash location corresponding to that number Special keys that can be used while running the main core (ZX Spectrum): @@ -1059,7 +1059,7 @@ At this moment, `romsupgr`, only works correctly with RomPack files using a maxi [NOTE] ==== -Remember that if the ZXDOS+ is started by pressing the `/` key (on the numeric keyboard) (`Symbol Shift+V` in gomaDOS+), then the default ROM of the ZX Spectrum core will be loaded in" root "mode. +Remember that if the ZXDOS+ is started by pressing the `/` key (on the numeric keyboard, `Symbol Shift+V` in gomaDOS+), then the default ROM of the ZX Spectrum core will be loaded in" root "mode. ==== To do the opposite process (save the ROMs in a RomPack file named `ROMS.ZX1`), you can use the` .romsback` command. @@ -2228,6 +2228,30 @@ Sometimes (e.g. when installing an experimental core or when upgrading the ZX Sp When this happens, there are several recovery methods that let you install again the firmware. +==== JTAG cable connections + +Later, in some of the recovery steps, when talking about jump wires or USB-Blaster connections to ZXDOS, you can use these images as reference. + +[.text-center] +image:img/jtag.jpg[pdfwidth=25%] image:img/jtaggomados.jpg[pdfwidth=40%] + +Take note, that on some models, the JTAG pins are at the under the board. + +[.text-center] +image:img/jtag02.jpg[pdfwidth=25%] image:img/jtag03.jpg[pdfwidth=25%] image:img/jtag04.jpg[pdfwidth=25%] + +[WARNING] +==== +*DO NOT* connect the 3V line +==== + +[NOTE] +==== +When using USB-Blaster, a gomaDOS+ is ready to connect directly the 2x5 connector. For a ZXDOS+, it may be necessary to prepare the cables, looking at the previous images. +==== + +<<<< + ==== Recovery using a Raspberry Pi *Hardware required*: @@ -2242,8 +2266,6 @@ When this happens, there are several recovery methods that let you install again - Flash image and recovery file for ZXDOS+ (LX25), from the https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[official repository] -<<< - *Instruction Steps*: . Install Raspberry Pi OS (formely known as Raspbian) to the Raspberry Pi SD card (using https://www.raspberrypi.org/downloads/raspberry-pi-os/[the official download], https://www.raspberrypi.org/downloads/noobs/[NOOBS], https://github.com/procount/pinn[PINN], etc.) @@ -2265,23 +2287,10 @@ cd .. rm -rf ./openocd-code ---- +<<<< + [start=3] -. Connect USB-Blaster or jump wires if using GPIO. In this case, open the ZXDOS+ or gomaDOS+ case and connect the FPGA JTAG lines (`TMS`, `TDI`, `TDO`, `TCK` y `GND`), using the wires, to the Raspberry Pi https://es.wikipedia.org/wiki/GPIO[GPIO] pins. - -[.text-center] -image:img/jtag.jpg[pdfwidth=25%] image:img/jtaggomados.jpg[pdfwidth=40%] - -[WARNING] -==== -*DO NOT* connect the 3V line -==== - -[NOTE] -==== -When using USB-Blaster, a gomaDOS+ is ready to connect directly the 2x5 connector. For a ZXDOS+, it will be necessary to prepare the cables, comparing those last two images. -==== - -<<< +. Connect USB-Blaster or jump wires if using GPIO. In this case, open the ZXDOS+ or gomaDOS+ case and, <<#_jtag_cable_connections,as explained before>> connect the FPGA JTAG lines (`TMS`, `TDI`, `TDO`, `TCK` y `GND`), using the wires, to the Raspberry Pi https://es.wikipedia.org/wiki/GPIO[GPIO] pins. Is using a GPIO connection, take note of the chosen pins, making sure that `GND` is connected with `GND`. @@ -2435,13 +2444,13 @@ For a gomaDOS+, since the recovery image uses a PS/2 configuration as default, f *Hardware required*: -- USB-Blaster cable. Using the right pins for ZXDOS+ +- USB-Blaster cable. Using the right pins for ZXDOS+, <<#_jtag_cable_connections,as explained earlier>> - Flash Image file and y recovery file fo ZXDOS+ (LX25). The same ones as for Raspberry Pi, from the https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[official repository] -- Mac OS -- Extra data folder for UrJTAG, obtained from https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[here] *Software required*: +- Mac OS +- Extra data folder for UrJTAG, obtained from https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[here] - https://brew.sh[Homebrew for Mac OS] - UrJTAG: following instructions from https://n4abi.com/posts/2018-07-08-de0-nano-urjtag.html[here]: @@ -2559,6 +2568,101 @@ When using Linux with `urjtag`, the process should be quite similar, although th <<<< +==== Recovery using Windows and USB-Blaster cable + +*Hardware required*: + +- USB-Blaster cable. Using the right pins for ZXDOS+, <<#_jtag_cable_connections,as explained earlier>> +- Flash Image file and y recovery file fo ZXDOS+ (LX25). The same ones as for Raspberry Pi, from the https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[official repository] + +*Software required*: + +- Windows +- USB-Blaster drivers for Windows, available at https://www.zxuno.com/forum/viewtopic.php?f=25&t=432[ZX-Uno forums] +- UrJTAG, for Windows, available at https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[the official repository] + +*Instruction Steps*: + +. Extract the ZIP file with drivers (obtained from the https://www.zxuno.com/forum/download/file.php?id=889[ZX-Uno forums]) + +. Plug USB-Blaster to the Windows PC and install the driver choosing to select manually installation files and using the folder `drivers` obtained after extracting the ZIP + +. Extract UrJTAG Windows software, obtained at the https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[official repository] + +. Copy `FLASH.ZXD` file to the root of the ZXDOS+ microSD card. + +. Connect USB-Blaster cable to ZXDOS+ and the PC + +. Make sure that you are in the directory where `recovery.zxd.bit` is, and execute `jtag` command. + +. Turn on the ZXDOS+ or gomaDOS+. + +. A new shell appears. Now type the commands: + +[source,shell] +---- +cable usbblaster +detect +pld load recovery.zxd.bit +---- + +<<<< + +[start=9] +. If all goes well, we will see that the FPGA LED change their state and the BIOS is shown on the display. + +If there is no image on the display, press `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup. + +[.text-center] +image:img/recovery.png[pdfwidth=70%] + +[start=10] +. Insert in the ZXDOS+ the microSD card formatted as FAT16 o FAT32, and with the `FLASH.ZXD` file https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[downloaded previously]. + +. Unplug the USB-Blaster. + +. Select the option `Upgrade Flash from SD`. Press Enter, choose `Yes`, and press Enter again to start the Flash writing process. + +[.text-center] +image:img/recovery2.png[pdfwidth=70%] + +[WARNING] +==== +This process can't be undone, and it will replace all the previously installed cores, the BIOS, the ZX Spectrum ROMs and their configuration with the data in the image file. +==== + +[NOTE] +==== +Ususally, the recovery image is set to use a PS/2 keyboard so, for a gomaDOS+, some key combinations, like `Caps Shift + 5`, etc may not work. In this case, you have to change the keyboard mode to `PC XT`(`Caps Shift + Symbol Shift + U` and then `9`), to make them work temporarily. +==== + +[start=13] +. After some minutes, the process will end, and, after turning the ZXDOS+ off and on, it should start fine. + +[NOTE] +==== +If no image is shown, press again `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change <<#_advanced, the right advanced setting>> that matches your display. +==== + +[NOTE] +==== +For a gomaDOS+, since the recovery image uses a PS/2 configuration as default, follow this steps to set up the BIOS correctly: + +. If you see no image, switch between composite and VGA mode (`Caps Shift+Symbol Shift+G`) +. Change to `PC XT` keyboard mode (`Caps Shift + Symbol Shift + U` and then `9`) +. Reboot gomaDOS+ without losing the temporary keyboard mode (`Caps Shift + Symbol Shift + B`) +. Quickly, press `Caps Shift + 1` +. Again, if there's no image, switch between composite and VGA mode (`Caps Shift+Symbol Shift+G`) +. Navigate through BIOS and turno on these options: +- `Advanced` -> `Keyboard Layout`: `Spectrum` +- `Advanced` -> `Video`: `VGA` (only if there was no image) +. Save changes: +- `Exit` -> `Save changes and exit` +. Completely turn off gomaDOS` and turn it on again +==== + +<<<< + == References http://zxuno.speccy.org/index.shtml[ZX-Uno] diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.pdf b/doc/English ZXDOS+ and gomaDOS+ Manual.pdf index 3cd9161..12d747e 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 feb899e..314d67a 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.3.1 +:revnumber: 1.3.2 :doctype: book :front-cover-image: image:img/portada.jpg[] :email: kounch@users.noreply.github.com @@ -827,7 +827,7 @@ Teclas especiales durante el arranque: - `Bloq. Mayús` o `Cursor abajo` (`Caps Shift+2` en gomaDOS+): Menú de selección de cores - `Esc` (`Caps Shift+Espacio` en gomaDOS+): Menú de selección de ROMS del core de ZX Spectrum - `R`: Carga la rom del core de ZX Spectrum en modo "real" deshabilitando esxdos, nuevos modos gráficos, etc. -- `/` (del teclado numérico): Carga la ROM por defecto del core de ZX Spectrum en modo "root" +- `/` (del teclado numérico, `Symbol Shift+V` en gomaDOS+): Carga la ROM por defecto del core de ZX Spectrum en modo "root" - Número del `1` al `9`: Cargar el core en la ubicación de la Flash correspondiente a dicho número Teclas especiales que se pueden utilizar durante la ejecución del core principal (ZX Spectrum): @@ -1055,7 +1055,7 @@ Para actualizar las ROM instaladas para ZX Spectrum de forma masiva, se ha de ob [NOTE] ==== -Recordar que, si se inicia el ZXDOS+ pulsando la tecla `/` (del teclado numérico) (`Symbol Shift+V` en gomaDOS+), entonces se cargará la ROM por defecto del core de ZX Spectrum en modo "root". +Recordar que, si se inicia el ZXDOS+ pulsando la tecla `/` (del teclado numérico, `Symbol Shift+V` en gomaDOS+), entonces se cargará la ROM por defecto del core de ZX Spectrum en modo "root". ==== Para hacer el proceso contrario (guardar las ROMs en un fichero RomPack llamado `ROMS.ZX1`), se puede usar el comando `.romsback`. @@ -2233,6 +2233,31 @@ En algunos casos (por ejemplo al instalar un core experimental o hacer una actua En esta situación, existen diferentes métodos de recuperación que permiten volver a instalar el firmware. +==== Preparación del cableado + +En los siguientes pasos de recuperación se habla de conectar cables puente o USB-Blaster a la placa de ZXDOS+ o gomaDOS+. Para ello, usar las siguientes imágenes como referencia. + +[.text-center] +image:img/jtag.jpg[pdfwidth=25%] image:img/jtaggomados.jpg[pdfwidth=40%] + +Notar que, en algunos modelos, el conector de JTAG está con los pines por la parte de debajo. + +[.text-center] +image:img/jtag02.jpg[pdfwidth=25%] image:img/jtag03.jpg[pdfwidth=25%] image:img/jtag04.jpg[pdfwidth=25%] + + +[WARNING] +==== +*NO* se ha de conectar la línea de 3V +==== + +[NOTE] +==== +En el caso de utilizar USB-Blaster, el gomaDOS+ tiene la distribución adecuada para conectar directamente el conector 2x5 incluido. Para ZXDOS+, podría ser necesario preparar el cableado adecuado, comparando las imágenes anteriores. +==== + +<<< + ==== Recuperación usando una Raspberry Pi *Material necesario*: @@ -2247,8 +2272,6 @@ En esta situación, existen diferentes métodos de recuperación que permiten vo - Imagen Flash y recovery para ZXDOS+ (LX25), del https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[repositorio oficial, en este enlace] -<<< - *Pasos a seguir*: . Si no estuviera ya, instalar Raspberry Pi OS (antes llamado Raspbian) en la Raspberry Pi (usando https://www.raspberrypi.org/downloads/raspberry-pi-os/[la descarga oficial], https://www.raspberrypi.org/downloads/noobs/[NOOBS], https://github.com/procount/pinn[PINN], etc.) @@ -2270,23 +2293,10 @@ cd .. rm -rf ./openocd-code ---- +<<<< + [start=3] -. Conectar el USB-Blaster o los cables puente para GPIO. Si se va a hacer la conexión usando GPIO, abrir la carcasa del ZXDOS+ o el gomaDOS+ y conectar las líneas de JTAG de la FPGA (`TMS`, `TDI`, `TDO`, `TCK` y `GND`) con los cables a los pines https://es.wikipedia.org/wiki/GPIO[GPIO] de la Raspberry Pi. - -[.text-center] -image:img/jtag.jpg[pdfwidth=25%] image:img/jtaggomados.jpg[pdfwidth=40%] - -[WARNING] -==== -*NO* se ha de conectar la línea de 3V -==== - -[NOTE] -==== -En el caso de utilizar USB-Blaster, el gomaDOS+ tiene la distribución adecuada para conectar directamente el conector 2x5 incluido. Para ZXDOS+, será necesario preparar el cableado adecuado, comparando las dos imágenes anteriores. -==== - -<<< +. Conectar el USB-Blaster o los cables puente para GPIO <<#_preparación_del_cableado,tal y como se explica anterioremente>>. Si se va a hacer la conexión usando GPIO, abrir la carcasa del ZXDOS+ o el gomaDOS+ y conectar las líneas de JTAG de la FPGA (`TMS`, `TDI`, `TDO`, `TCK` y `GND`) con los cables a los pines https://es.wikipedia.org/wiki/GPIO[GPIO] de la Raspberry Pi. Si se hace conexión vía GPIO, tomar nota de los pines elegidos, teniendo cuidado de conectar `GND` con `GND`. @@ -2320,6 +2330,9 @@ En este ejemplo, se utilizarán los pines `31`, `33`, `35`, `37` y `39` (corresp [start=4] . Copiar en la Raspberry Pi el fichero `recovery.zxd.bit` obtenido anteriormente del https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[repositorio oficial]. En nuestro ejemplo, se dejará en `/home/pi/zxdosplus/unbrick/` +<<<< + +[start=5] . Para la conexión usando GPIO, realizar una copia del archivo de configuración de Open OCD, en el mismo lugar donde está `recovery.zxd.bit`. Este paso no es necesario si se usa USB-Blaster. [source,shell] @@ -2327,8 +2340,6 @@ En este ejemplo, se utilizarán los pines `31`, `33`, `35`, `37` y `39` (corresp cp /usr/local/share/openocd/scripts/interface/raspberrypi2-native.cfg /home/pi/zxdosplus/unbrick/ ---- -<<< - [start=6] . Para la conexión vía GPIO, editar la copia de `raspberrypi2-native.cfg` actualizando `bcm2835gpio_jtag_nums` (y descomentando, si fuera necesario), según como se haya hecho la conexión entre JTAG y GPIO en la línea `bcm2835gpio_jtag_nums`. En nuestro ejemplo: @@ -2374,8 +2385,8 @@ Con USB-Blaster: sudo openocd -f /usr/local/share/openocd/scripts/interface/altera-usb-blaster.cfg -f /usr/local/share/openocd/scripts/cpld/xilinx-xc6s.cfg -c "init; xc6s_program xc6s.tap; pld load 0 recovery.zxd.bit ; exit" ---- -<<< - +<<<< + [start=11] . Si todo va bien, veremos cómo cambia el estado de los LED de la FPGA y veremos la imagen de la BIOS en el monitor. @@ -2440,13 +2451,13 @@ En el caso de gomaDOS+, como la configuración de la imagen de recuperación por *Material necesario*: -- Cable USB-Blaster. Preparado con las conexiones adecuadas para ZXDOS+ +- Cable USB-Blaster <<#_preparación_del_cableado,preparado con las conexiones adecuadas para ZXDOS+>> - Imagen Flash y recovery para ZXDOS+ (LX25). Los mismos que se indican para Raspberry pi, del https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[repositorio oficial, en este enlace] -- Sistema MacOS -- Carpeta data adicional para UrJTAG, obtenido desde https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[aqui] *Software necesario*: +- Sistema MacOS +- Carpeta data adicional para UrJTAG, obtenido desde https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[aqui] - https://brew.sh[Homebrew para MacOS] - UrJTAG: según las instrucciones de https://n4abi.com/posts/2018-07-08-de0-nano-urjtag.html[este enlace]: @@ -2474,7 +2485,7 @@ sudo make install ---- [start=4] -. Copiar el archivo FLASH.ZXD en la raiz de la tarjeta microSD para el ZXDOS+. +. Copiar el archivo `FLASH.ZXD` en la raiz de la tarjeta microSD para el ZXDOS+. . Conectar el cable USB-Blaster al ZXDOS+ y al Mac @@ -2564,6 +2575,101 @@ En Linux, usando el mismo software UrJTAG, el proceso deberia ser similar, aunqu <<<< +==== Recuperación usando Windows y Cable USB-Blaster + +*Material necesario*: + +- Cable USB-Blaster. <<<<#_preparación_del_cableado,preparado con las conexiones adecuadas para ZXDOS+>> +- Imagen Flash y recovery para ZXDOS+ (LX25). Los mismos que se indican para Raspberry pi, del https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[repositorio oficial, en este enlace] + +*Software necesario*: + +- Sistema Windows +- Drivers de USB-Blaster para Windows, disponible en https://www.zxuno.com/forum/viewtopic.php?f=25&t=432[el foro de ZX-Uno] +- UrJTAG, para Windows, disponible en https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[el repositorio oficial] + +*Pasos a seguir*: + +. Descomprimir el fichero ZIP con los drivers (obtenido en https://www.zxuno.com/forum/download/file.php?id=889[el foro de ZX-Uno]) + +. Conectar el cable USB-Blaster al PC con Windows e instalar el driver eligiendo la opción de añadir ficheros manualmente y seleccionado la carpeta `drivers` que se ha obtenido al descomprimir el fichero anterior + +. Descomprimir el software de UrJTAG, obtenido en https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[el repositorio oficial] + +. Copiar el archivo `FLASH.ZXD` en la raiz de la tarjeta microSD para el ZXDOS+. + +. Conectar el cable USB-Blaster al ZXDOS+ y al PC con Windows + +. Encender el ZXDOS+ o el gomaDOS+ + +. Asegurarnos de que estamos en el directorio donde se encuentra el archivo `recovery.zxd.bit`, y lanzar `jtag.exe`. + +. Aparecerá una consola donde se han de escribir los comandos: + +[source,shell] +---- +cable usbblaster +detect +pld load recovery.zxd.bit +---- + +<<<< + +[start=9] +. Si todo va bien, veremos cómo cambia el estado de los LED de la FPGA y veremos la imagen de la BIOS en el monitor. + +En el caso de que no se vea imagen, pulsar `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de video compuesto y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. + +[.text-center] +image:img/recovery.png[pdfwidth=70%] + +[start=10] +. Insertar en el ZXDOS+ la tarjeta microSD con la primera partición en formato FAT16 o FAT32, y en la que habremos copiado el fichero `FLASH.ZXD` https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[descargado anteriormente]. + +. Desconectar el cable USB-Blaster. + +. Elegir la opción `Upgrade Flash from SD`. Pulsar Enter, elegir `Yes`, y pulsar Enter de nuevo para comenzar el proceso que graba de nuevo la Flash. + +[.text-center] +image:img/recovery2.png[pdfwidth=70%] + +[WARNING] +==== +Este proceso sustituirá todos los cores instalados, la BIOS, así como las ROMs de ZX Spectrum y la configuración por lo que haya en la imagen, y no se puede deshacer. +==== + +[NOTE] +==== +Habitualmente, la imagen de recuperación está configurada para usar un teclado PS/2 y no el teclado de membrana de Spectrum, así que, en el caso de gomaDOS+, puede que no funcionen las combinaciones como `Caps Shift + 5`, etc. En este caso, se ha de cambiar el modo de teclado a `PC XT` (`Caps Shift + Symbol Shift + U` y luego `9`), para que funcionen de nuevo temporalmente. +==== + +[start=13] +. Tras unos minutos, el proceso finalizará, y podremos comprobar como, al apagar y encender, el ZXDOS+ (o el gomaDOS+) vuelve a arrancar correctamente. + +[NOTE] +==== +Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de video compuesto y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. +==== + +[NOTE] +==== +En el caso de gomaDOS+, como la configuración de la imagen de recuperación por defecto espera un teclado PS/2, se pueden seguir los siguientes pasos para configurar la BIOS correctamente: + +. Si no hay imagen, cambiar entre modo video compuesto y modo VGA (`Caps Shift+Symbol Shift+G`) +. Cambiar al modo `PC XT` de teclado (`Caps Shift + Symbol Shift + U` y luego `9`) +. Reiniciar el gomaDOS+ sin que se pierda la configuración del teclado (`Caps Shift + Symbol Shift + B`) +. Rápidamente, pulsar `Caps Shift + 1` +. De nuevo, si no hay imagen, cambiar entre modo VGA y modo video compuesto (`Caps Shift+Symbol Shift+G`) +. Navegar por la BIOS y configurar las siguientes opciones: +- `Advanced` -> `Keyboard Layout`: `Spectrum` +- `Advanced` -> `Video`: `VGA` (sólo si no teníamos imagen) +. Guardar los cambios de la BIOS: +- `Exit` -> `Save changes and exit` +.Apagar completamente el gomaDOS+ y volver a encenderlo +==== + +<<<< + == Referencias http://zxuno.speccy.org/index.shtml[ZX-Uno] diff --git a/doc/Manual de ZXDOS+ y gomaDOS+.pdf b/doc/Manual de ZXDOS+ y gomaDOS+.pdf index 410e22f..9fee42f 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/jtag02.jpg b/doc/img/jtag02.jpg new file mode 100644 index 0000000..6e270df Binary files /dev/null and b/doc/img/jtag02.jpg differ diff --git a/doc/img/jtag03.jpg b/doc/img/jtag03.jpg new file mode 100644 index 0000000..69a4101 Binary files /dev/null and b/doc/img/jtag03.jpg differ diff --git a/doc/img/jtag04.jpg b/doc/img/jtag04.jpg new file mode 100644 index 0000000..2dbfef5 Binary files /dev/null and b/doc/img/jtag04.jpg differ diff --git a/doc/index.html b/doc/index.html index 0a467b2..095ff7f 100644 --- a/doc/index.html +++ b/doc/index.html @@ -446,7 +446,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
kounch
kounch@users.noreply.github.com
-version 1.3.1 +version 1.3.2
Index
@@ -665,8 +665,10 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
  • Firmware recovery
    • @@ -1927,7 +1929,7 @@ NEW DATA "Utils",8

    R: Loads the Spectrum core ROM in "real" mode, disabling esxdos, new graphics modes, etc.

  • -

    / (numeric keyboard): Load the default ZX Spectrum core ROM in "root" mode

    +

    / (numeric keyboard, Symbol Shift+V on gomaDOS+): Load the default ZX Spectrum core ROM in "root" mode

  • Number from 1 to 9: Load the core in the flash location corresponding to that number

    @@ -2422,7 +2424,7 @@ NEW DATA "Utils",8
    -

    Remember that if the ZXDOS+ is started by pressing the / key (on the numeric keyboard) (Symbol Shift+V in gomaDOS+), then the default ROM of the ZX Spectrum core will be loaded in" root "mode.

    +

    Remember that if the ZXDOS+ is started by pressing the / key (on the numeric keyboard, Symbol Shift+V in gomaDOS+), then the default ROM of the ZX Spectrum core will be loaded in" root "mode.

    @@ -4457,6 +4459,50 @@ Port: <Previously identified port>

    When this happens, there are several recovery methods that let you install again the firmware.

    • +

    JTAG cable connections

    +
    +

    Later, in some of the recovery steps, when talking about jump wires or USB-Blaster connections to ZXDOS, you can use these images as reference.

    +
    +
    +

    jtag jtaggomados

    +
    +
    +

    Take note, that on some models, the JTAG pins are at the under the board.

    +
    +
    +

    jtag02 jtag03 jtag04

    +
    +
    + + + + + +
    + + +
    +

    DO NOT connect the 3V line

    +
    +
    +
    +
    + + + + + +
    + + +
    +

    When using USB-Blaster, a gomaDOS+ is ready to connect directly the 2x5 connector. For a ZXDOS+, it may be necessary to prepare the cables, looking at the previous images.

    +
    +
    +
    +
    +
    +

    Recovery using a Raspberry Pi

    Hardware required:

    @@ -4490,7 +4536,6 @@ Port: <Previously identified port>
    -

    Instruction Steps:

    @@ -4520,45 +4565,14 @@ cd .. rm -rf ./openocd-code
    +
    1. -

      Connect USB-Blaster or jump wires if using GPIO. In this case, open the ZXDOS+ or gomaDOS+ case and connect the FPGA JTAG lines (TMS, TDI, TDO, TCK y GND), using the wires, to the Raspberry Pi GPIO pins.

      +

      Connect USB-Blaster or jump wires if using GPIO. In this case, open the ZXDOS+ or gomaDOS+ case and, as explained before connect the FPGA JTAG lines (TMS, TDI, TDO, TCK y GND), using the wires, to the Raspberry Pi GPIO pins.

    -
    -

    jtag jtaggomados

    -
    -
    - - - - - -
    - - -
    -

    DO NOT connect the 3V line

    -
    -
    -
    -
    - - - - - -
    - - -
    -

    When using USB-Blaster, a gomaDOS+ is ready to connect directly the 2x5 connector. For a ZXDOS+, it will be necessary to prepare the cables, comparing those last two images.

    -
    -
    -
    -

    Is using a GPIO connection, take note of the chosen pins, making sure that GND is connected with GND.

    @@ -4843,17 +4857,11 @@ bcm2835gpio_jtag_nums 26 6 13 19
    @@ -4862,6 +4870,12 @@ bcm2835gpio_jtag_nums 26 6 13 19
    +
    +

    Recovery using Windows and USB-Blaster cable

    +
    +

    Hardware required:

    +
    +
    + +
    +
    +

    Software required:

    +
    +
    + +
    +
    +

    Instruction Steps:

    +
    +
    +
      +
    1. +

      Extract the ZIP file with drivers (obtained from the ZX-Uno forums)

      +
      2. +
    2. +

      Plug USB-Blaster to the Windows PC and install the driver choosing to select manually installation files and using the folder drivers obtained after extracting the ZIP

      +
      3. +
    3. +

      Extract UrJTAG Windows software, obtained at the official repository

      +
      4. +
    4. +

      Copy FLASH.ZXD file to the root of the ZXDOS+ microSD card.

      +
      5. +
    5. +

      Connect USB-Blaster cable to ZXDOS+ and the PC

      +
      6. +
    6. +

      Make sure that you are in the directory where recovery.zxd.bit is, and execute jtag command.

      +
      7. +
    7. +

      Turn on the ZXDOS+ or gomaDOS+.

      +
      8. +
    8. +

      A new shell appears. Now type the commands:

      +
      9. +
    +
    +
    +
    +
    cable usbblaster
+detect
+pld load recovery.zxd.bit
    +
    +
    +
    +
    +
      +
    1. +

      If all goes well, we will see that the FPGA LED change their state and the BIOS is shown on the display.

      +
      2. +
    +
    +
    +

    If there is no image on the display, press Scroll Lock (Caps Shift+Symbol Shift+G on gomaDOS+): to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup.

    +
    +
    +

    recovery

    +
    +
    +
      +
    1. +

      Insert in the ZXDOS+ the microSD card formatted as FAT16 o FAT32, and with the FLASH.ZXD file downloaded previously.

      +
      2. +
    2. +

      Unplug the USB-Blaster.

      +
      3. +
    3. +

      Select the option Upgrade Flash from SD. Press Enter, choose Yes, and press Enter again to start the Flash writing process.

      +
      4. +
    +
    +
    +

    recovery2

    +
    +
    + + + + + +
    + + +
    +

    This process can’t be undone, and it will replace all the previously installed cores, the BIOS, the ZX Spectrum ROMs and their configuration with the data in the image file.

    +
    +
    +
    +
    + + + + + +
    + + +
    +

    Ususally, the recovery image is set to use a PS/2 keyboard so, for a gomaDOS+, some key combinations, like Caps Shift + 5, etc may not work. In this case, you have to change the keyboard mode to PC XT(Caps Shift + Symbol Shift + U and then 9), to make them work temporarily.

    +
    +
    +
    +
    +
      +
    1. +

      After some minutes, the process will end, and, after turning the ZXDOS+ off and on, it should start fine.

      +
      2. +
    +
    +
    + + + + + +
    + + +
    +

    If no image is shown, press again Scroll Lock (Caps Shift+Symbol Shift+G on gomaDOS+): to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change the right advanced setting that matches your display.

    +
    +
    +
    +
    + + + + + +
    + + +
    +

    For a gomaDOS+, since the recovery image uses a PS/2 configuration as default, follow this steps to set up the BIOS correctly:

    +
    +
    +
      +
    1. +

      If you see no image, switch between composite and VGA mode (Caps Shift+Symbol Shift+G)

      +
      2. +
    2. +

      Change to PC XT keyboard mode (Caps Shift + Symbol Shift + U and then 9)

      +
      3. +
    3. +

      Reboot gomaDOS+ without losing the temporary keyboard mode (Caps Shift + Symbol Shift + B)

      +
      4. +
    4. +

      Quickly, press Caps Shift + 1

      +
      5. +
    5. +

      Again, if there’s no image, switch between composite and VGA mode (Caps Shift+Symbol Shift+G)

      +
      6. +
    6. +

      Navigate through BIOS and turno on these options:

      +
      +
        +
      • +

        Advanced → Keyboard Layout: Spectrum

        +
        • +
      • +

        Advanced → Video: VGA (only if there was no image)

        +
        • +
      +
      +
      7. +
    7. +

      Save changes:

      +
      +
        +
      • +

        Exit → Save changes and exit

        +
        • +
      +
      +
      8. +
    8. +

      Completely turn off gomaDOS` and turn it on again

      +
      9. +
    +
    +
    +
    +
    +
    @@ -5224,8 +5447,8 @@ pld load recovery.zxd.bit