From 250707b64dffa62d4f928aeeda020ffe52b09ab2 Mon Sep 17 00:00:00 2001 From: RichardG867 Date: Sat, 18 Jul 2020 20:35:35 -0300 Subject: [PATCH] Finish the settings section, add a new disk images page --- settings/floppycdrom.rst | 33 +++++++++++++++++++++ settings/index.rst | 2 ++ settings/removable.rst | 16 ++++++++++ usage/diskimages.rst | 63 ++++++++++++++++++++++++++++++++++++++++ usage/imageformats.rst | 4 --- usage/index.rst | 2 +- 6 files changed, 115 insertions(+), 5 deletions(-) create mode 100644 settings/floppycdrom.rst create mode 100644 settings/removable.rst create mode 100644 usage/diskimages.rst delete mode 100644 usage/imageformats.rst diff --git a/settings/floppycdrom.rst b/settings/floppycdrom.rst new file mode 100644 index 0000000..efed56c --- /dev/null +++ b/settings/floppycdrom.rst @@ -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 `_ 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. diff --git a/settings/index.rst b/settings/index.rst index 7fc43ad..0508438 100644 --- a/settings/index.rst +++ b/settings/index.rst @@ -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 diff --git a/settings/removable.rst b/settings/removable.rst new file mode 100644 index 0000000..35b14aa --- /dev/null +++ b/settings/removable.rst @@ -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. diff --git a/usage/diskimages.rst b/usage/diskimages.rst new file mode 100644 index 0000000..eec7224 --- /dev/null +++ b/usage/diskimages.rst @@ -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 `_. +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. \ No newline at end of file diff --git a/usage/imageformats.rst b/usage/imageformats.rst deleted file mode 100644 index 48b46b3..0000000 --- a/usage/imageformats.rst +++ /dev/null @@ -1,4 +0,0 @@ -Supported disk image formats -============================ - -Placeholder page. \ No newline at end of file diff --git a/usage/index.rst b/usage/index.rst index 82ff6fe..0d2d734 100644 --- a/usage/index.rst +++ b/usage/index.rst @@ -9,5 +9,5 @@ This section contains information on how to use 86Box and its emulated hardware gettingstarted machinespecific - imageformats + diskimages ideterqua