Manual 1.3.1

Añadido esquema de particiones para +3e y core de Spectrum
Añadido manual en HTML
This commit is contained in:
kounch 2021-01-16 16:25:02 +01:00
parent 5ff321bcd0
commit 1bfccc0748
6 changed files with 11438 additions and 4 deletions

View File

@ -1,6 +1,6 @@
= ZXDOS+ and gomaDOS+ Manual
:author: kounch
:revnumber: 1.3.0
:revnumber: 1.3.1
:doctype: book
:front-cover-image: image:img/portada.jpg[]
:email: kounch@users.noreply.github.com
@ -96,7 +96,7 @@ In order to take advantage of its full potential, you may also have:
==== microSD card formatting
In order to use a microSD card, it has to be formmatted with, at least, one FAT16 or FAT32 format (depending on the case, one or the other format is recommended for compatibility with different third-party cores). It must be the first partition if there are more than one, except for the Spectrum core wich can use the first partition in +3DOS format, and then the second one in FAT16 or FAT32 format.
In order to use a microSD card, it has to be formmatted with, at least, one FAT16 or FAT32 format (depending on the case, one or the other format is recommended for compatibility with different third-party cores). It must be the first partition if there are more than one, except for the Spectrum core wich can have <<#_microsd_advanced_format_3e,the first partition in +3DOS format, and then the second one in FAT16 or FAT32 format>> to use with a +3e ROM.
[NOTE]
====
@ -525,6 +525,270 @@ These are some of its main characteristics:
- User selectable vertical refresh rate to improve compatibility with VGA monitors.
- Multicore boot support: from the Spectrum you can select an address of the SPI Flash and the FPGA will load a core from there.
<<<<
=== microSD advanced format (+3e)
ZX Spectrum +3e is one ROM that can be used with ZX Spectrum core. This is an improved Sinclair ZX Spectrum +3, wich can use hard disks or memory cards.
+3e uses its own partition format (called IDEDOS), to split de hard disk into several partitions to store data. ROM version 1.28 and later can share IDEDOS partitions with MBR partitions. In other case, you must reserve the whole card for IDEDOS partitions.
[WARNING]
====
The following partition scheme can only be used with ZX Spectrum core.
====
[TIP]
====
Each partition in IDEDOS can be between 1 and 16 Megabytes (1 million bytes) in size, and each disk can have between 1 and 65535 partitions. This means that the maximum space used in a card is about 1GB.
====
This is one method to split a card into two or three parts, with the first partition IDEDOS (1GB), the second one FAT16 (4GB) and the third one FAT32 (using the remaining space in the card).
exsdos and other programs can be installed into the second partition <<#_esxdos,as explained earlier>>.
==== Windows
You can use Windows Disk Management utility. The steps are:
. Remove all partitions from the card
. Create a new extended partition, using the desired space for IDEDOS
. Create a primary partition, 4GB in size, and format as FAT16
. Optionally, create another primary partition using the remaining space and format as FAT32
==== MacOS
You will have to use the command line. The first task is to find out which device is the disk to format:
[source,shell]
----
diskutil list
----
For this example, it will be disk 6:
[source]
----
(...)
/dev/disk6 (external, physical):
#: TYPE NAME SIZE IDENTIFIER
0: FDisk_partition_scheme *15.9 GB disk6
1: DOS_FAT_32 UNKNOWN 15.9 GB disk6s1
----
<<<<
Instruction steps:
. Unmount the disk and edit the partition sceme (the second step requires admin privileges):
[source,shell]
----
diskutil unmountDisk /dev/disk6
sudo fdisk -e /dev/rdisk6
----
[source]
----
fdisk: could not open MBR file /usr/standalone/i386/boot0: No such file or directory
Enter 'help' for information
fdisk: 1> erase
fdisk:*1> edit 1
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 7F
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [63] 128
Partition size [1 - 31116287]: [31116287] 2017152
fdisk:*1> edit 2
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 0E
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [2017280]
Partition size [1 - 29099135]: [29099135] 7812504
fdisk:*1> flag 2
fdisk:*1> edit 3
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 0B
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [9829784]
Partition size [1 - 21286504]: [21286504]
fdisk:*1> print
Starting Ending
#: id cyl hd sec - cyl hd sec [ start - size]
------------------------------------------------------------------------
1: 7F 1023 254 63 - 1023 254 63 [ 128 - 2017152] <Unknown ID>
2: 0E 1023 254 63 - 1023 254 63 [ 2017280 - 7812504] DOS FAT-16
3: 0B 1023 254 63 - 1023 254 63 [ 9829784 - 21286504] Win95 FAT-32
4: 00 0 0 0 - 0 0 0 [ 0 - 0] unused
fdisk:*1> write
fdisk: 1> quit
----
[start=2]
. Format the FAT partitions (admin privileges required)
[source,shell]
----
diskutil unmountDisk /dev/disk6
sudo newfs_msdos -F 16 -v ZXDOSPLUS -b 4096 -c 128 /dev/rdisk6s2
sudo newfs_msdos -F 32 -v EXTRA -b 4096 -c 128 /dev/rdisk6s3
----
[start=3]
. Confirm that the new partition scheme has been applied:
[source,shell]
----
diskutil list
----
[source]
----
(...)
/dev/disk6 (external, physical):
#: TYPE NAME SIZE IDENTIFIER
0: FDisk_partition_scheme *15.9 GB disk6
1: 0x7F 1.0 GB disk6s1
2: Windows_FAT_16 ZXDOSPLUS 4.0 GB disk6s2
3: DOS_FAT_32 EXTRA 10.9 GB disk6s3
----
==== Linux
You can use the command line. First, find out the device to erase:
[source,shell]
----
lsblk
----
For this example, it will be `sdc`:
[source]
----
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
(..)
sdc 179:0 0 15,8G 0 disk
└─sdc1 179:1 0 15,8G 0 part
----
<<<<
Instructions:
. Verify that the disk isn't mounted and edit the partition scheme (this step requires root privileges):
[source,shell]
----
sudo fdisk -e /dev/sdc
----
[source]
----
Enter 'help' for information
fdisk: 1> erase
fdisk:*1> edit 1
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 7F
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [63] 128
Partition size [1 - 31116287]: [31116287] 2017152
fdisk:*1> edit 2
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 0E
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [2017280]
Partition size [1 - 29099135]: [29099135] 7812504
fdisk:*1> flag 2
fdisk:*1> edit 3
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 0B
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [9829784]
Partition size [1 - 21286504]: [21286504]
fdisk:*1> print
Starting Ending
#: id cyl hd sec - cyl hd sec [ start - size]
------------------------------------------------------------------------
1: 7F 1023 254 63 - 1023 254 63 [ 128 - 2017152] <Unknown ID>
2: 0E 1023 254 63 - 1023 254 63 [ 2017280 - 7812504] DOS FAT-16
3: 0B 1023 254 63 - 1023 254 63 [ 9829784 - 21286504] Win95 FAT-32
4: 00 0 0 0 - 0 0 0 [ 0 - 0] unused
fdisk:*1> write
fdisk: 1> quit
----
[start=2]
. Format both FAT partitions (requires root privileges)
[source,shell]
----
sudo mkfs.fat -F 16 /dev/sdc2
sudo mkfs.fat -F 32 /dev/sdc3
----
<<<<
[start=3]
. Confirm that the partition scheme has been changed:
[source,shell]
----
lsblk
----
[source]
----
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
(...)
sda 179:0 0 15,8G 0 disk
├─sda1 179:1 0 1G 0 part
├─sda2 179:2 0 4G 0 part
├─sda3 179:3 0 10,8G 0 part
----
==== +3e
Once the microSD card is ready to use, you can start Spectrum core with a +3e ROM and format the IDEDOS part.
The first step is determine the disk geometry. With the cart inserted into the ZXDOS+, type the command:
[source,basic]
----
CAT TAB
----
This will give a result showing the number of https://en.wikipedia.org/wiki/Cylinder-head-sector[cylinders, heads and sectors].
Whith this info, we estimate the size of our partition, using cylinders. For example, if the number of cylinders is 32768, and we want to use 1GB of a 16GB card, the number of cylinders needes would be 32768/16=2048. This way, the IDEDOS partition can be formatted using that number:
[source,basic]
----
FORMAT TO 0,100,2048
----
The first value (`0`) is the drive to use (the first one), the second value is the maximum number of IDEDOS partitions, and the third one yis the number of cylinders to use.
Once formatted, you can create new partitions. For example, to create a 16MB partition with the name "Software", another 4GB partition named "Swap" (to use as swap) and another one name "Utils", 8MB in size:
[source,basic]
----
NEW DATA "Software",16
NEW EXP "Swap1",4
NEW DATA "Utils",8
----
For more information about the different +3e disk commands , you can check https://worldofspectrum.org/zxplus3e/index.html[this page at World of Spectrum].
<<<
=== Keyboard
The keyboard map (physical keys of the keyboard assignment to the keystrokes that are presented to the different cores) is changed using the `Advanced` menu of the BIOS. There are three different maps to choose from: Spanish (default), English, and Spectrum (advanced).
@ -2305,6 +2569,10 @@ https://docs.google.com/document/d/1NI0zgCDRk7c-5CVi-lfZEK6q8Lnpnco7PhpsEEdxD60/
http://www.zxuno.com/wiki/index.php/ZX_Spectrum[Core ZX Spectrum]
https://worldofspectrum.org/zxplus3e/index.html[The ZX Spectrum +3e Homepage]
https://worldofspectrum.org/zxplus3e/sharingdisks.html[Sharing a +3e disk with PC (FAT) partitions]
http://www.zxuno.com/forum/viewtopic.php?f=37&t=208[Layouts de teclado]
https://github.com/spark2k06/zxunops2/blob/master/Alternative/Nuevo%20firmware%20de%20teclado%20ZX-GO%2B.pdf[Firmware de teclado para ZX Go+]

View File

@ -1,6 +1,6 @@
= Manual de ZXDOS+ y gomaDOS+
:author: kounch
:revnumber: 1.3.0
:revnumber: 1.3.1
:doctype: book
:front-cover-image: image:img/portada.jpg[]
:email: kounch@users.noreply.github.com
@ -96,7 +96,7 @@ Para poder aprovechar todo su potencial, es útil tener también:
==== Formato de la tarjeta microSD
Para poder utilizar una tarjeta microSD, esta debe tener, al menos, una partición (la primera en el caso de haber varias) en formato FAT16 o FAT32 (según el caso, se recomienda uno u otro formato para compatibilidad con distintos cores de terceros). Para el core de Spectrum, tambén es posible tener una primera partición en formato +3DOS y luego otra en formato FAT16 o FAT32.
Para poder utilizar una tarjeta microSD, esta debe tener, al menos, una partición (la primera en el caso de haber varias) en formato FAT16 o FAT32 (según el caso, se recomienda uno u otro formato para compatibilidad con distintos cores de terceros). Para el core de Spectrum, tambén es posible tener <<#_formato_avanzado_de_la_tarjeta_microsd_3e,una primera partición en formato +3DOS y luego otra(s) en formato FAT16 o FAT32>>, para su uso con una ROM de +3e.
[NOTE]
====
@ -523,6 +523,273 @@ Estas son algunas de sus principales características:
- Frecuencia de refresco vertical seleccionable por el usuario para mejorar la compatibilidad con monitores VGA.
- Soporte de arranque multicore: desde el Spectrum se puede seleccionar una dirección de la SPI Flash y la FPGA cargará un core desde ahí.
<<<<
=== Formato avanzado de la tarjeta microSD (+3e)
Una de las ROM que se pueden cargar con el core de ZX Spectrum es la de ZX Spectrum +3e, que es una versión mejorada del Sinclair ZX Spectrum +3, y que soporta el uso de discos duros o tarjetas de memoria.
El +3e usa su propio esquema de particionado (llamado IDEDOS) para dividir el disco duro en diferentes particiones donde se pueden almacenar datos. Se necesita una version 1.28 o superior de la ROM para poder compartir particiones IDEDOS con particiones MBR. En otro caso, se ha dedicar la tarjeta completa al particionado IDEDOS.
[WARNING]
====
El esquema de particionado que se presentará a continuación sólo se podrá utilizar con el core de Spectrum.
====
[TIP]
====
En IDEDOS, cada partición puede tener un tamaño entre 1 y 16 Megabytes (un millón de bytes), y cada disco puede tener entre 1 y 65535 particiones. Por tanto, lo máximo que se puede ocupar de una tarjeta será alrededor de 1GB de espacio.
====
A continuación se explica una forma de dividir una tarjeta en dos o tres partes, con la primera partición IDEDOS (1GB de tamaño), la segunda FAT16 (4GB) y la tercera FAT32 (resto del espacio de la tarjeta).
En la segunda particion se puede instalar, tal y como se explicó anteriormente <<#_esxdos,exsdos>> y otros programas.
==== Windows
Se puede utilizar el administrador de discos de Windows. Los pasos a seguir serían:
. Eliminar todas las particiones de la tarjeta
. Crear una partición extendida, del tamaño que se quiera utilizar para IDEDOS
. Crear una partición primaria de 4GB y formatear como FAT16
. Opcionalmente, crear otra partición primaria ocupando el resto del espacio y formatear como FAT32
<<<<
==== MacOS
Será necesario utilizar la línea de comandos. Lo primero es determinar el disco a formatear:
[source,shell]
----
diskutil list
----
En este ejemplo sería el disco 6:
[source]
----
(...)
/dev/disk6 (external, physical):
#: TYPE NAME SIZE IDENTIFIER
0: FDisk_partition_scheme *15.9 GB disk6
1: DOS_FAT_32 UNKNOWN 15.9 GB disk6s1
----
Pasos a seguir:
. Expulsar el disco y editar el esquema de particiones (el segundo paso requiere permisos de administrador):
[source,shell]
----
diskutil unmountDisk /dev/disk6
sudo fdisk -e /dev/rdisk6
----
[source]
----
fdisk: could not open MBR file /usr/standalone/i386/boot0: No such file or directory
Enter 'help' for information
fdisk: 1> erase
fdisk:*1> edit 1
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 7F
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [63] 128
Partition size [1 - 31116287]: [31116287] 2017152
fdisk:*1> edit 2
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 0E
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [2017280]
Partition size [1 - 29099135]: [29099135] 7812504
fdisk:*1> flag 2
----
[source]
----
fdisk:*1> edit 3
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 0B
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [9829784]
Partition size [1 - 21286504]: [21286504]
fdisk:*1> print
Starting Ending
#: id cyl hd sec - cyl hd sec [ start - size]
------------------------------------------------------------------------
1: 7F 1023 254 63 - 1023 254 63 [ 128 - 2017152] <Unknown ID>
2: 0E 1023 254 63 - 1023 254 63 [ 2017280 - 7812504] DOS FAT-16
3: 0B 1023 254 63 - 1023 254 63 [ 9829784 - 21286504] Win95 FAT-32
4: 00 0 0 0 - 0 0 0 [ 0 - 0] unused
fdisk:*1> write
fdisk: 1> quit
----
[start=2]
. Formatear las particiones FAT (requiere permisos de administrador)
[source,shell]
----
diskutil unmountDisk /dev/disk6
sudo newfs_msdos -F 16 -v ZXDOSPLUS -b 4096 -c 128 /dev/rdisk6s2
sudo newfs_msdos -F 32 -v EXTRA -b 4096 -c 128 /dev/rdisk6s3
----
[start=3]
. Comprobar cómo el esquema de particiones ha cambiado y ya es el que se deseaba:
[source,shell]
----
diskutil list
----
[source]
----
(...)
/dev/disk6 (external, physical):
#: TYPE NAME SIZE IDENTIFIER
0: FDisk_partition_scheme *15.9 GB disk6
1: 0x7F 1.0 GB disk6s1
2: Windows_FAT_16 ZXDOSPLUS 4.0 GB disk6s2
3: DOS_FAT_32 EXTRA 10.9 GB disk6s3
----
==== Linux
Será necesario utilizar la línea de comandos. Lo primero es determinar el disco a formatear:
[source,shell]
----
lsblk
----
<<<<
En este ejemplo sería `sdc`:
[source]
----
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
(..)
sdc 179:0 0 15,8G 0 disk
└─sdc1 179:1 0 15,8G 0 part
----
Pasos a seguir:
. Comprobar que no está montado y editar el esquema de particiones (este paso requiere permisos de root):
[source,shell]
----
sudo fdisk -e /dev/sdc
----
[source]
----
Enter 'help' for information
fdisk: 1> erase
fdisk:*1> edit 1
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 7F
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [63] 128
Partition size [1 - 31116287]: [31116287] 2017152
fdisk:*1> edit 2
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 0E
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [2017280]
Partition size [1 - 29099135]: [29099135] 7812504
fdisk:*1> flag 2
fdisk:*1> edit 3
Partition id ('0' to disable) [0 - FF]: [0] (? for help) 0B
Do you wish to edit in CHS mode? [n]
Partition offset [0 - 31116288]: [9829784]
Partition size [1 - 21286504]: [21286504]
fdisk:*1> print
Starting Ending
#: id cyl hd sec - cyl hd sec [ start - size]
------------------------------------------------------------------------
1: 7F 1023 254 63 - 1023 254 63 [ 128 - 2017152] <Unknown ID>
2: 0E 1023 254 63 - 1023 254 63 [ 2017280 - 7812504] DOS FAT-16
3: 0B 1023 254 63 - 1023 254 63 [ 9829784 - 21286504] Win95 FAT-32
4: 00 0 0 0 - 0 0 0 [ 0 - 0] unused
fdisk:*1> write
fdisk: 1> quit
----
[start=2]
. Formatear las particiones FAT (requiere permisos de root)
[source,shell]
----
sudo mkfs.fat -F 16 /dev/sdc2
sudo mkfs.fat -F 32 /dev/sdc3
----
[start=3]
. Verificar que el esquema de particiones ha cambiado y ya es el que se quería:
[source,shell]
----
lsblk
----
[source]
----
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
(...)
sda 179:0 0 15,8G 0 disk
├─sda1 179:1 0 1G 0 part
├─sda2 179:2 0 4G 0 part
├─sda3 179:3 0 10,8G 0 part
----
==== +3e
Una vez preparada la tarjeta para su uso, se puede arrancar el core de Spectrum con una ROM de +3e, y formatear la parte de IDEDOS según se desee.
El primer paso consiste en determinar la geometría de la microSD. Con la tarjeta insertada en el ZXDOS+, desde el core de Spectrum con la ROM de +3e, ejecutar el comando:
[source,basic]
----
CAT TAB
----
Esto devoverá un resultado indicando el número de https://es.wikipedia.org/wiki/Cilindro-Cabezal-Sector[cilindros, cabezales y sectores].
Teniendo esto en cuenta, calculamos el espacio que ocupa nuestra partición, en cilindros. Por ejemplo, si el número de cilindros obtenido es de 32768, y queremos utilizar 1GB de una tarjeta de 16GB, el número de cilindros que se necesitarían son 32768/16=2048. Por tanto, podemos formatear la partición IDEDOS usando ese número:
[source,basic]
----
FORMAT TO 0,100,2048
----
El primer valor (`0`) indica el disco a utilizar (el primero), el segundo valor es el número máximo de particiones IDEDOS que se podrán usar, y el tercer valor es el número de cilindros a utilizar.
<<<<
Una vez hecho el formato, ya será posible crear nuevas particiones. Por ejemplo, para crear una partición llamada "Software" de 16MB, una llamada "Swap1", de 4MB (para usar como espacio swap) y otra llamada "Utils" de 8MB:
[source,basic]
----
NEW DATA "Software",16
NEW EXP "Swap1",4
NEW DATA "Utils",8
----
Para más información sobre el uso de los distintos comandos de +3e para acceso al disco, se puede visitar https://worldofspectrum.org/zxplus3e/espanol/index.html[esta página en World of Spectrum].
<<<
=== Teclado
El mapa de teclado (asignación de las teclas físicas del teclado con las pulsaciones que se presentan a los distinto cores) se cambia desde el menú `Advanced` de la BIOS. Existen tres mapas distintos a elegir: Español (por defecto), inglés, y Spectrum (avanzado).
@ -2307,6 +2574,10 @@ https://docs.google.com/document/d/1NI0zgCDRk7c-5CVi-lfZEK6q8Lnpnco7PhpsEEdxD60/
http://www.zxuno.com/wiki/index.php/ZX_Spectrum[Core ZX Spectrum]
https://worldofspectrum.org/zxplus3e/index.html[The ZX Spectrum +3e Homepage]
https://worldofspectrum.org/zxplus3e/sharingdisks.html[Sharing a +3e disk with PC (FAT) partitions]
http://www.zxuno.com/forum/viewtopic.php?f=37&t=208[Layouts de teclado]
https://github.com/spark2k06/zxunops2/blob/master/Alternative/Nuevo%20firmware%20de%20teclado%20ZX-GO%2B.pdf[Firmware de teclado para ZX Go+]

Binary file not shown.

5443
doc/index.html Normal file

File diff suppressed because it is too large Load Diff

5452
doc/indice.html Normal file

File diff suppressed because it is too large Load Diff