mirror/86Box-docs
1
0
Fork 0
mirror of https://github.com/86Box/docs.git synced 2026-02-21 17:15:33 -07:00
Code Issues Packages Projects Releases Wiki Activity

Move hardware usage pages to their own category

Browse Source
This commit is contained in:
RichardG867
2020-08-05 20:10:06 -03:00
parent a502e7d2f5
commit 026e3c47f2
14 changed files with 95 additions and 94 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
usage/diskimages.rst → hardware/diskimages.rst
View File

@@ -1,7 +1,7 @@
Disk images
===========
86Box supports a large variety of disk image formats for the emulated drives.
86Box supports a large variety of disk image formats for the emulated disk drives.
Hard disk images
----------------
@@ -22,6 +22,25 @@ Supported formats:
\* Raw images come in many extensions, including: img ima
Hard disk size limits
^^^^^^^^^^^^^^^^^^^^^
There are limits to how big of a hard disk an emulated machine can accept. Such limits will vary depending on the machine's age. Here are a few important ones:
+---------------+---------+---------+-----+-------+
|Limit |Disk size|Cylinders|Heads|Sectors|
+===============+=========+=========+=====+=======+
|20-bit CHS |504 MB |1024 |16 |63 |
+---------------+---------+---------+-----+-------+
|Extended CHS |8032 MB |1024 |256 |63 |
+---------------+---------+---------+-----+-------+
|65535 cylinders|32255 MB |65535 |16 |63 |
+---------------+---------+---------+-----+-------+
|48-bit LBA |131071 MB|Not applicable |
+---------------+---------+-----------------------+
These limits can be worked around (with caveats) by using software such as *Ontrack Disk Manager*, except for the 131071 MB one which is a hard limit of 86Box's hard disk emulation.
Floppy disk images
------------------
@@ -101,6 +120,6 @@ Supported formats:
CD audio
^^^^^^^^
Compact Disc Digital Audio (CDDA) is supported on **Cue sheet** images. CD audio playback is muted on all emulated CD-ROM drives by default; it can be unmuted by unchecking the *Mute* option for the respective drive on the :ref:`status bar <usage/statusbar:|cdrom| |nbsp| CD-ROM drives>` or the :ref:`Media menu <usage/menubar:Media>`.
Compact Disc Digital Audio (CDDA) playback through the emulated CD-ROM drive is supported on **Cue sheet** images. Audio output is muted on all drives by default; it can be unmuted by unchecking the *Mute* option for the respective drive on the :ref:`status bar <usage/statusbar:|cdrom| |nbsp| CD-ROM drives>` or :ref:`Media menu <usage/menubar:Media>`.
.. note:: Only raw format (.bin) tracks are supported. Compressed or otherwise encapsulated audio tracks (.wav, .mp3, .ogg, .flac and other formats) are not supported.

38
usage/ideterqua.rst → hardware/ideterqua.rst
View File

@@ -1,11 +1,12 @@
Tertiary and quaternary IDE
===========================
The additional tertiary and quaternary IDE controllers, enabled through the :ref:`settings/peripherals:Tertiary / Quaternary IDE Controller` settings, are not supported by all BIOSes and may require manual configuration of guest operating systems. The specific details are outlined on this page.
The additional tertiary and quaternary IDE controllers, enabled through the :ref:`Peripherals settings page <settings/peripherals:Tertiary / Quaternary IDE Controller>`, are not supported by all emulated BIOSes and may require manual configuration of guest operating systems. The specific details are outlined on this page.
The following system resources are used by these additional controllers:
System resources
----------------
.. _table:
The following resources are used by these additional controllers:
+----------+-------------+---------------+---+
|Channel |Main I/O port|Status I/O port|IRQ|
@@ -15,22 +16,27 @@ The following system resources are used by these additional controllers:
|Quaternary|01E8h |03EEh |11 |
+----------+-------------+---------------+---+
These controllers are not Plug and Play compliant. If the emulated machine supports ISA PnP or PCI, remember to mark the IRQ(s) as being used by a legacy ISA device in the BIOS setup utility.
.. note:: While the IRQ for each channel can be changed through its respective *Settings* button on :ref:`settings/peripherals:Tertiary / Quaternary IDE Controller`, many operating systems do not allow legacy (ISA or VLB) IDE controllers to use custom IRQs.
BIOS support
------------
The tertiary and quaternary channels are both not visible and not bootable in any BIOS, with the exception of **MR BIOS version 3**, which provides full support for them, including bootability and INT 13h services.
The tertiary and quaternary channels are not visible and not bootable by any BIOS currently emulated by 86Box. The only exception is **MR BIOS version 3**, which provides full support for them, including bootability and INT 13h services.
Operating system support
------------------------
DOS and real mode
-----------------
^^^^^^^^^^^^^^^^^
DOS and other real mode operating systems rely on the BIOS-provided INT 13h services to access hard disks. These are only provided for the tertiary and quaternary channels by **MR BIOS version 3**, as mentioned above.
DOS and other real mode operating systems rely on INT 13h services provided by the BIOS to access hard disks. These are only provided for the tertiary and quaternary channels by **MR BIOS version 3**, as mentioned above.
Windows 95, 98 and Me
---------------------
^^^^^^^^^^^^^^^^^^^^^
The Windows 9x family will only detect and enable both additional channels during installation :ref:`if the BIOS supports them <usage/ideterqua:BIOS support>`. Each additional channel can be enabled after installation through the following procedure:
The Windows 9x family will only detect and enable both additional channels during installation :ref:`if the BIOS supports them <hardware/ideterqua:BIOS support>`. Each additional channel can be enabled after installation through the following steps:
1. Go to the *Add New Hardware* control panel.
2. Add a *Standard IDE/ESDI Hard Disk Controller* from the *Hard disk controllers* category.
@@ -39,7 +45,7 @@ The Windows 9x family will only detect and enable both additional channels durin
5. Select the newly-added *Standard IDE/ESDI Hard Disk Controller* device from the *Hard disk controllers* category and click *Properties*.
6. Go to the *Resources* tab.
7. Select *Basic configuration 4* in the *Settings based on* box.
8. Change the resource settings to match the :ref:`table above <table>`. The first *Input/Output Range* range corresponds to the **main** I/O port, the second one corresponds to the **status** I/O port, and *Interrupt Request* corresponds to the IRQ.
8. Change the resource settings to match the :ref:`table above <hardware/ideterqua:System resources>`. The first *Input/Output Range* range corresponds to the **main** I/O port, the second one corresponds to the **status** I/O port, and *Interrupt Request* corresponds to the IRQ.
* The status I/O port range is off by 6 units. Select 0368 for the tertiary channel or 03E8 for the quaternary channel.
* The image below shows an example configuration for the tertiary channel.
@@ -50,25 +56,25 @@ The Windows 9x family will only detect and enable both additional channels durin
:align: center
Windows NT, 2000 and XP
-----------------------
^^^^^^^^^^^^^^^^^^^^^^^
The Windows NT 4 and 5 families will automatically detect and enable both additional channels during installation, regardless of BIOS support. This auto-detection does not, however, work on machines with **Award BIOS**, except for the version which identifies itself as *Phoenix - AwardBIOS v6.00PG*, where it does work.
The Windows NT family (starting with 3.5) will automatically detect and enable both additional channels during installation, regardless of BIOS support. This auto-detection does not, however, work on machines with **Award BIOS**, except for the version which identifies itself as *Phoenix - AwardBIOS v6.00PG*, where it does work.
.. note:: If you install the system to a hard disk on one of the additional channels, it will not be bootable if the BIOS doesn't support booting from these channels.
On Windows 2000 only, the additional channels can be enabled after the system is installed through *Add New Hardware* similarly to Windows 95/98/Me above, although the I/O ports and IRQ cannot be changed. *Basic configuration 0003* corresponds to the **tertiary** channel, while *Basic configuration 0002* corresponds to the **quaternary** channel.
Windows Vista and 7
-------------------
^^^^^^^^^^^^^^^^^^^
The Windows NT 6 family does not support legacy non-Plug-and-Play IDE controllers, and therefore cannot use the additional channels as currently implemented in 86Box.
The Windows NT 6 family no longer supports legacy non-Plug-and-Play IDE controllers, and therefore cannot use the additional channels as currently emulated by 86Box.
Linux
-----
^^^^^
On kernels 2.6.19 and newer (after the switch to ``libata``), run the ``modprobe pata_legacy probe_all=1`` command as root to enable both additional channels. Consult your distribution's documentation on how to load that module on startup.
On kernels with ``libata`` (typically 2.6.19 and newer), run the ``modprobe pata_legacy probe_all=1`` command as root to enable both additional channels. Consult your distribution's documentation on how to load that module on startup.
On kernels older than 2.6.19 (before the switch to ``libata``), add the following parameters to the kernel command line to enable their respective channels:
On kernels without ``libata`` (typically older than 2.6.19), add the following parameters to the kernel command line to enable their respective channels:
* **Tertiary:** ``ide2=0x168,0x36e,10`` (assuming IRQ 10)
* **Quaternary:** ``ide3=0x1e8,0x3ee,11`` (assuming IRQ 11)

0
usage/images/ideterqua_win98.png → hardware/images/ideterqua_win98.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 5.2 KiB

After

Width:  |  Height:  |  Size: 5.2 KiB

0
usage/machinespecific.rst → hardware/machinespecific.rst
View File

8
usage/network.rst → hardware/network.rst
View File

@@ -6,7 +6,7 @@ Networking
SLiRP
-----
SLiRP creates a private network with a virtual router, allowing the emulated machine to reach the host, its network and the Internet; on the other hand, the host and other devices on its network cannot reach the emulated machine, unless :ref:`port forwarding <usage/network:SLiRP port forwarding>` is configured. This is similar to the **NAT** mode on other virtualizers.
SLiRP creates a private network with a virtual router, allowing the emulated machine to reach the host, its network and the Internet; on the other hand, the host and other devices on its network cannot reach the emulated machine, unless :ref:`port forwarding <hardware/network:SLiRP port forwarding>` is configured. This is similar to the **NAT** mode on other virtualizers.
The virtual router provides automatic IP configuration to the emulated machine through DHCP. If that is not an option, use the following static IP settings:
@@ -17,7 +17,7 @@ The virtual router provides automatic IP configuration to the emulated machine t
The host can be reached through IP address 10.0.2.2, while other devices on the host's network can be reached through their normal IP addresses.
.. note:: SLiRP is only capable of routing TCP and UDP traffic. Other protocols such as IPX and NetBEUI can only be used with :ref:`usage/network:PCap` networking.
.. note:: SLiRP is only capable of routing TCP and UDP traffic. Other protocols such as IPX and NetBEUI can only be used with :ref:`hardware/network:PCap` networking.
PCap
----
@@ -39,8 +39,8 @@ If you have an incompatible network connection (such as Wi-Fi), or if you wish t
* If VMware is installed, use one of the VMnet adapters included with it.
* VMnet1 (host-only) connects to the host only.
* VMnet8 (NAT) connects to the host, its network and the Internet.
* *VMnet1* (Host-only) connects to the host only.
* *VMnet8* (NAT) connects to the host, its network and the Internet.
Advanced features
-----------------

13
index.rst
View File

@@ -32,10 +32,15 @@ to retro computing and, of course, 86Box. We look forward to hearing from you!
usage/menubar
usage/statusbar
settings/index
usage/machinespecific
usage/diskimages
usage/ideterqua
usage/network
.. toctree::
:maxdepth: 1
:caption: Emulated Hardware
hardware/machinespecific
hardware/diskimages
hardware/ideterqua
hardware/network
.. toctree::
:maxdepth: 1

16
settings/floppycdrom.rst
View File

@@ -8,18 +8,18 @@ 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 settings apply to the selected drive:
* **Type:** Type of floppy drive to emulate. Some drive types have special properties:
* **Type:** floppy drive to emulate. Some types have special properties and therefore should only be used if you know what you're doing:
* **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.
* **5.25" 1.2M PS/2** and **3.5" 1.44M PS/2:** IBM PS/2 drives, which invert the polarity of 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 if the emulated machine's BIOS supports 3-mode operation.
* **3.5" 1.44M PC-98:** NEC PC-98 drives, which are 3-mode and invert the polarity of 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.
* **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 with some operating systems and applications.
* **Check BPB:** if unchecked, 86Box will ignore 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:`hardware/diskimages:Floppy disk detection` for more details.
.. note:: Disabling "Check BPB" may be required in order to access UNIX/Linux installation floppies or other non-DOS disks, as outlined on the page linked above.
Floppy disk images can be inserted and removed through the status bar or the *Media* menu.
Floppy disk images can be inserted and removed through the :ref:`status bar <usage/statusbar:|floppy_35| |floppy_525| |nbsp| Floppy drives>` or :ref:`Media menu <usage/menubar:Media>`.
CD-ROM drives
-------------
@@ -30,4 +30,4 @@ Up to four CD-ROM / DVD-ROM optical disc drives can be attached to the emulated
* **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.
CD-ROM / DVD-ROM disc images can be inserted and removed through the :ref:`status bar <usage/statusbar:|cdrom| |nbsp| CD-ROM drives>` or :ref:`Media menu <usage/menubar:Media>`.

73
settings/hdd.rst
View File

@@ -18,39 +18,31 @@ Adding a new disk
The *New...* button opens a new window allowing you to create an existing hard disk image file.
* **File name:** where to save the disk image file.
* See :ref:`usage/diskimages:Hard disk images` for a list of supported image formats.
* **File name:** where to save the disk image file. See :ref:`hardware/diskimages:Hard disk images` for a list of supported image formats.
* **Cylinders/Heads/Sectors:** CHS parameters for the disk image. These boxes control the *Size (MB)* box below.
* **Size (MB):** the disk image's size in MB. This box controls the *Cylinders*, *Heads* and *Sectors* boxes above.
* See :ref:`limits` for information on disk size limits.
* **Size (MB):** the disk image's size in MB. This box controls the *Cylinders*, *Heads* and *Sectors* boxes above. There are limits to how big a hard disk image can be; see :ref:`hardware/diskimages:Hard disk size limits` for more information.
* **Bus:** bus to attach the disk to.
* **Channel**/**ID:** where to attach the disk on the selected bus.
* **Channel**/**ID:** where to attach the disk on the selected bus. The *Channel* value for IDE has two numbers, which correspond to an IDE channel and device, respectively:
* The *Channel* value for the IDE bus has two numbers, which correspond to an IDE channel and device, respectively:
+---------+-----------+------+
|*Channel*|IDE channel|Device|
+=========+===========+======+
|0:0 |Primary |Master|
+---------+-----------+------+
|0:1 |Primary |Slave |
+---------+-----------+------+
|1:0 |Secondary |Master|
+---------+-----------+------+
|1:1 |Secondary |Slave |
+---------+-----------+------+
|2:0 |Tertiary |Master|
+---------+-----------+------+
|2:1 |Tertiary |Slave |
+---------+-----------+------+
|3:0 |Quaternary |Master|
+---------+-----------+------+
|3:1 |Quaternary |Slave |
+---------+-----------+------+
+---------+-----------+------+
|*Channel*|IDE channel|Device|
+=========+===========+======+
|0:0 |Primary |Master|
+---------+-----------+------+
|0:1 |Primary |Slave |
+---------+-----------+------+
|1:0 |Secondary |Master|
+---------+-----------+------+
|1:1 |Secondary |Slave |
+---------+-----------+------+
|2:0 |Tertiary |Master|
+---------+-----------+------+
|2:1 |Tertiary |Slave |
+---------+-----------+------+
|3:0 |Quaternary |Master|
+---------+-----------+------+
|3:1 |Quaternary |Slave |
+---------+-----------+------+
Press the *OK* button to create the disk image file, or *Cancel* to close the window.
@@ -65,24 +57,3 @@ Removing a disk
---------------
Select a disk on the list and press *Remove* to remove it.
.. _limits:
Size limits
-----------
There are limits to how big of a hard disk an emulated machine can accept. Such limits will vary depending on the machine's age. Here are a few important ones:
+---------------+---------+---------+-----+-------+
|Limit |Disk size|Cylinders|Heads|Sectors|
+===============+=========+=========+=====+=======+
|20-bit CHS |504 MB |1024 |16 |63 |
+---------------+---------+---------+-----+-------+
|Extended CHS |8032 MB |1024 |256 |63 |
+---------------+---------+---------+-----+-------+
|65535 cylinders|32255 MB |65535 |16 |63 |
+---------------+---------+---------+-----+-------+
|48-bit LBA |131071 MB|Not applicable |
+---------------+---------+-----------------------+
These limits can be worked around (with caveats) by using software such as *Ontrack Disk Manager*, except for the 131071 MB one which is a hard limit of 86Box's hard disk emulation.

2
settings/input.rst
View File

@@ -6,7 +6,7 @@ The *Input devices* page contains settings related to the emulated machine's mou
Mouse
-----
Emulate a mouse pointing device. The following mouse types are supported:
Emulate a pointing device. The following mouse types are supported:
* **Bus mouse:** ISA expansion card with a mouse interface. The I/O port and IRQ used by the card are configurable.
* **Serial mouse:** connected to the serial port of your choosing. The selected serial port must be enabled in :ref:`settings/ports:Serial port 1-4`.

2
settings/network.rst
View File

@@ -6,7 +6,7 @@ The *Network* page contains settings related to the emulated machine's network c
Network type
------------
Network emulation mode to use. See :doc:`../usage/network` for more information on these.
Network emulation mode to use. See :doc:`../hardware/network` for more information on these.
* **None:** disable networking.
* **PCap:** connects directly to a host network adapter. Similar to the **Bridge** mode on other virtualizers.

2
settings/peripherals.rst
View File

@@ -35,7 +35,7 @@ Add a third or fourth (respectively) IDE channel to the emulated machine, throug
The IRQ used by each controller can be configured through its respective *Settings* button.
.. note:: The tertiary and quaternary channels may require manual configuration of guest operating systems, and may not be bootable. See :doc:`../usage/ideterqua` for more information.
.. note:: The tertiary and quaternary channels may require manual configuration of guest operating systems, and may not be bootable. See :doc:`../hardware/ideterqua` for more information.
ISABugger
---------

2
settings/removable.rst
View File

@@ -13,4 +13,4 @@ Up to four Magneto-Optical and four Iomega ZIP disk drives can be attached to th
* **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.
MO / ZIP disk images can be inserted and removed through the :ref:`status bar <usage/statusbar:|zip| |mo| |nbsp| ZIP and MO drives>` or :ref:`Media menu <usage/menubar:Media>`.

2
settings/sound.rst
View File

@@ -3,7 +3,7 @@ Sound
The *Sound* page contains settings related to the emulated machine's audio hardware.
Parallel port devices such as the **Disney Sound Source** and **Covox Speech Thing** are not present on this page; they can be configured through the :ref:`Ports page <settings/ports:LPT1-3 Device>`.
Parallel port sound devices such as the **Disney Sound Source** and **Covox Speech Thing** are not present on this page; they can be configured through the :ref:`Ports page <settings/ports:LPT1-3 Device>`.
Sound card
----------

8
usage/statusbar.rst
View File

@@ -28,7 +28,7 @@ The status bar located at the bottom of the 86Box window provides icons related
A 3.5" or 5.25" floppy icon will appear for each configured :ref:`floppy drive <settings/floppycdrom:Floppy drives>`.
* **New image:** create a new disk image file. Opens the *New Image* window, which lets you select the image size and where to save the file.
* **Existing image:** insert a :ref:`disk image file <usage/diskimages:Floppy disk images>` into this drive.
* **Existing image:** insert a :ref:`disk image file <hardware/diskimages:Floppy disk images>` into this drive.
* **Existing image (Write-protected):** insert a disk image file into this drive as a read-only disk.
* **Export to 86F:** convert the currently-inserted disk image file to 86Box's :doc:`../formats/86f` surface image format. You will be asked where to save the converted file.
* **Eject:** remove the currently-inserted disk from this drive.
@@ -38,10 +38,10 @@ A 3.5" or 5.25" floppy icon will appear for each configured :ref:`floppy drive <
A CD icon will appear for each configured :ref:`CD-ROM drive <settings/floppycdrom:CD-ROM drives>`.
* **Mute:** mute any :ref:`usage/diskimages:CD audio` played through this drive. **CD audio is muted by default on all drives.**
* **Mute:** mute any :ref:`hardware/diskimages:CD audio` played through this drive. **CD audio is muted by default on all drives.**
* **Empty:** remove any disc inserted into this drive.
* **Reload previous image:** reinsert the last disc image file selected through the *Image* option.
* **Image:** insert a :ref:`CD-ROM or DVD-ROM disc image file <usage/diskimages:CD-ROM / DVD-ROM optical disc images>` into this drive.
* **Image:** insert a :ref:`CD-ROM or DVD-ROM disc image file <hardware/diskimages:CD-ROM / DVD-ROM optical disc images>` into this drive.
|zip| |mo| |nbsp| ZIP and MO drives
-----------------------------------
@@ -49,7 +49,7 @@ A CD icon will appear for each configured :ref:`CD-ROM drive <settings/floppycdr
A ZIP or MO icon will appear for each configured :doc:`additional removable storage drive <../settings/removable>`.
* **New image:** create a new disk image file. Opens the *New Image* window, which lets you select the image size and where to save the file.
* **Existing image:** insert a :ref:`disk image file <usage/diskimages:MO / ZIP removable disk images>` into this drive.
* **Existing image:** insert a :ref:`disk image file <hardware/diskimages:MO / ZIP removable disk images>` into this drive.
* **Existing image (Write-protected):** insert a disk image file into this drive as a read-only disk.
* **Eject:** remove the currently-inserted disk from this drive.
* **Reload previous image:** reinsert the last disk image file selected through the *Existing image* options.