Finish the settings section, add a new disk images page

This commit is contained in:
RichardG867
2020-07-18 20:35:35 -03:00
parent 54bef84fbe
commit 250707b64d
6 changed files with 115 additions and 5 deletions

33
settings/floppycdrom.rst Normal file
View File

@@ -0,0 +1,33 @@
Floppy and CD-ROM drives
========================
The *Floppy and CD-ROM drives* page contains settings related to the emulated machine's base removable devices.
Floppy drives
-------------
Up to four floppy disk drives can be attached to the emulated system, although not all BIOSes provide support for more than two drives. The following options apply to the selected drive:
* **Type:** Type of floppy drive to emulate. Some drive types have special properties:
* **5.25" 1.2M PS/2** and **3.5" 1.44M PS/2:** IBM PS/2 drives, which have inverted polarity on the Density Select pin.
* **5.25" 1.2M 300/360 RPM** and **3.5" 1.44M 300/360 RPM**: "3-mode" drives, which are capable of reading 360K 5.25" or PC-98 3.5" disks. BIOS support for 3-mode floppy drives is required.
* **3.5" 1.44M PC-98:** NEC PC-98 drives, which are 3-mode and have inverted polarity on the Density Select pin.
* **Turbo timings:** Run the drive mechanism as fast as possible. This decreases access time and makes some incorrectly-dumped floppies readable, but may cause issues some operating systems and applications.
* **Check BPB:** When disabled, 86Box will skip checking the `DOS BIOS Parameter Block <https://en.wikipedia.org/wiki/BIOS_parameter_block>`_ when determining the physical media format for a floppy image on this drive. See :ref:`usage/diskimages:Floppy disk detection` for more details.
.. note:: Disabling "Check BPB" may be required in order to access UNIX/Linux installation floppies or other raw stream disks, as outlined on the page linked above.
Floppy disk images can be inserted and removed through the status bar or the *Media* menu.
CD-ROM drives
-------------
Up to four CD-ROM / DVD-ROM optical disc drives can be attached to the emulated system. The following options apply to the selected drive:
* **Bus:** bus to attach the drive to. ATAPI (IDE) and SCSI are supported.
* **Channel**/**ID:** where to attach the drive on the selected bus. See :ref:`settings/hdd:Adding a new disk` for more information on IDE channels.
* **Speed:** maximum transfer speed for the drive. Up to 72x is supported.
CD-ROM / DVD-ROM disc images can be inserted and removed through the status bar or the *Media* menu.

View File

@@ -17,3 +17,5 @@ If any changes were made to the settings, you will be asked whether or not you w
ports
peripherals
hdd
floppycdrom
removable

16
settings/removable.rst Normal file
View File

@@ -0,0 +1,16 @@
Other removable devices
=======================
The *Other removable devices* page contains settings related to the emulated machine's additional removable devices.
MO / ZIP drives
---------------
Up to four Magneto-Optical and four Iomega ZIP disk drives can be attached to the emulated system. The following options apply to the selected drive:
* **Bus:** bus to attach the drive to. ATAPI (IDE) and SCSI are supported.
* **Channel**/**ID:** where to attach the drive on the selected bus. See :ref:`settings/hdd:Adding a new disk` for more information on IDE channels.
* **Type** (MO only): drive model to identify as. A list of real drive models is provided.
* **ZIP 250** (ZIP only): enable the drive to read and write 250 MB ZIP disks.
MO / ZIP disk images can be inserted and removed through the status bar or the *Media* menu.

63
usage/diskimages.rst Normal file
View File

@@ -0,0 +1,63 @@
Disk images
===========
Supported hard disk image formats
---------------------------------
+---------------------+--------------+
|Format |File extension|
+=====================+==============+
|**Raw image** |Many * |
+---------------------+--------------+
|Japanese FDI |.hdi |
+---------------------+--------------+
|:doc:`../formats/hdx`|.hdx |
+---------------------+--------------+
|Virtual Hard Disk |.vhd |
+---------------------+--------------+
\* Raw images come in many extensions, including: img ima
Supported floppy disk image formats
-----------------------------------
+---------------------+--------------+
|Format |File extension|
+=====================+==============+
|**Raw image** |Many * |
+---------------------+--------------+
|:doc:`../formats/86f`|.86f |
+---------------------+--------------+
|Formatted Disk Image |.fdi |
+---------------------+--------------+
|CopyQM |.cqm |
+---------------------+--------------+
|DiskDupe |.ddi |
+---------------------+--------------+
|EZ-DisKlone Plus |.fdf |
+---------------------+--------------+
|HxC MFM |.mfm |
+---------------------+--------------+
|ImageDisk |.imd |
+---------------------+--------------+
|Japanese FDI |.fdi |
+---------------------+--------------+
|PCjs JSON |.json |
+---------------------+--------------+
|Teledisk |.td0 |
+---------------------+--------------+
\* Raw images come in many extensions, including: img ima flp vfd
Floppy disk detection
---------------------
86Box detects the physical media format (sides, tracks per side, sectors per track, bytes per sector) of a floppy disk image through the following methods:
1. Data stored in the file header, except for Raw and DiskDupe formats where there is none.
2. Data stored in the `DOS BIOS Parameter Block <https://en.wikipedia.org/wiki/BIOS_parameter_block>`_.
3. If all else fails, a guess is made based on the file size.
The BIOS Parameter Block detection may result in incorrect behavior on *raw stream* (non-DOS) floppy disks. Installation floppies for UNIX and Linux are common examples of *raw stream* disks. Disabling the :ref:`settings/floppycdrom:Check BPB` option is strongly recommended for accessing these, as the inaccurate BPB detection may result in read errors, data corruption and other issues.
.. note:: When using a raw image of a raw stream floppy with the Check BPB option disabled, make sure the image file has the right size for its media type, otherwise incorrect behavior may still occur.

View File

@@ -1,4 +0,0 @@
Supported disk image formats
============================
Placeholder page.

View File

@@ -9,5 +9,5 @@ This section contains information on how to use 86Box and its emulated hardware
gettingstarted
machinespecific
imageformats
diskimages
ideterqua