From 457099f1aeba7ff109e511e3152fa1c8536b095a Mon Sep 17 00:00:00 2001 From: RichardG867 Date: Sat, 11 Jul 2020 01:33:10 -0300 Subject: [PATCH] Add some draft pages --- conf.py | 2 ++ index.rst | 3 +- settings/index.rst | 12 ++++++++ settings/machine.rst | 41 ++++++++++++++++++++++++++ usage/machinespecific.rst | 61 +++++++++++++++++++++++++++++++++++++++ 5 files changed, 118 insertions(+), 1 deletion(-) create mode 100644 settings/index.rst create mode 100644 settings/machine.rst create mode 100644 usage/machinespecific.rst diff --git a/conf.py b/conf.py index e9c3ee5..9197f25 100644 --- a/conf.py +++ b/conf.py @@ -30,7 +30,9 @@ author = '86Box Project' # ones. extensions = [ 'sphinx_rtd_theme', + 'sphinx.ext.autosectionlabel', ] +autosectionlabel_prefix_document = True # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] diff --git a/index.rst b/index.rst index 6fb9aaf..26c06c9 100644 --- a/index.rst +++ b/index.rst @@ -31,4 +31,5 @@ Documentation :maxdepth: 2 usage/gettingstarted - usage/machinespecific + settings/index + usage/machinespecific \ No newline at end of file diff --git a/settings/index.rst b/settings/index.rst new file mode 100644 index 0000000..029dcf9 --- /dev/null +++ b/settings/index.rst @@ -0,0 +1,12 @@ +Settings +======== + +The *Settings* window allows you to configure the emulated machine. + +If any changes were made to the settings, you will be asked whether or not you want to save the changes upon pressing *OK* or closing the window. Saving changes will hard reset the emulated machine. Press *Cancel* to immediately discard all changes. + +.. toctree:: + :maxdepth: 2 + :caption: Settings pages + + machine \ No newline at end of file diff --git a/settings/machine.rst b/settings/machine.rst new file mode 100644 index 0000000..7061024 --- /dev/null +++ b/settings/machine.rst @@ -0,0 +1,41 @@ +Machine +======= + +Machine type / Machine +---------------------- + +Machine/motherboard to emulate. The *Machine type* box lists all available processor classes, while the *Machine* box lists all available machines of the selected processor class. + +CPU type / CPU +-------------- + +Main processor to emulate. Only processors supported by the selected machine will be listed. + +FPU +--- + +Math co-processor to emulate. This box will not be enabled if a processor with an integrated math co-processor is selected. + +Wait states +----------- + +Number of memory wait states. This box is only enabled and relevant if a 286- or 386-class CPU is selected. + +Memory +------ + +Amount of RAM to give the emulated machine. The minimum and maximum amounts of RAM will vary depending on the selected machine. + +Dynamic Recompiler +------------------ + +Enable the dynamic recompiler, which provides faster but less accurate CPU emulation. The recompiler is available as an option for 486-class processors, and is mandatory starting with the Pentium. + +Time synchronization +-------------------- + +Time synchronization automatically copies your host machine's date and time settings over to the guest machine's hardware real-time clock. Synchronization is performed every time the guest operating system reads the hardware clock, which often happens once on every boot. + +* **Disabled:** do not perform time synchronization. +* **Enabled (local time):** synchronize the time in your host machine's configured timezone. Use this option when running a guest operating system which stores local time in the hardware clock, such as DOS or Windows. +* **Enabled (UTC):** synchronize the time in Coordinated Universal Time (UTC). Use this option when running a guest operating system which stores UTC time in the hardware clock, such as Linux. diff --git a/usage/machinespecific.rst b/usage/machinespecific.rst new file mode 100644 index 0000000..7309a82 --- /dev/null +++ b/usage/machinespecific.rst @@ -0,0 +1,61 @@ +Machine-specific notes +====================== + +80286 +----- + +.. rubric:: IBM AT + +* The diagnostics diskette is not Y2K-compliant, and will therefore produce error codes if :ref:`settings/machine:time synchronization` is enabled. These codes can be cleared by disabling time synchronization and then using a tool such as the MS-DOS ``date`` command to set the date to before the year 2000. + +Socket 7 +-------- + +.. _p65up5: +.. rubric:: ASUS P/I-P65UP5 (C-P55T2D) + +* A modular motherboard consisting of a baseboard (P/I-P65UP5) and one of the following CPU cards: + + * **C-P55T2D:** Socket 7 with Intel 430HX northbridge. + * **C-P6ND:** Socket 8 with Intel 440FX northbridge. + * **C-PKND:** Slot 1 with Intel 440FX northbridge. + +* While the northbridge depends on the selected CPU card, the southbridge always remains the Intel PIIX3, as it is located on the base board. +* The real CPU cards support dual CPUs. As 86Box does not emulate multiprocessing, only a single CPU will be present. +* Due to a lack of I/O APIC emulation at the moment, 86Box will patch the MultiProcessor Specification tables out of RAM before boot, so that operating systems will not hang or exhibit other erratic behavior due to the missing I/O APIC. + +Socket 8 +-------- + +.. rubric:: ASUS P/I-P65UP5 (C-P6ND) + +See: :ref:`p65up5` + +Slot 1 +------ + +.. rubric:: ASUS P/I-P65UP5 (C-PKND) + +See: :ref:`p65up5` + +.. _atc6310bxii: +.. rubric:: A-Trend ATC6310BXII + +* Equipped with the SMSC Victory66 southbridge instead of the regular Intel PIIX4E. + + * The Victory66 has faster IDE - up to Ultra ATA/66 as opposed to the PIIX4E's Ultra ATA/33 - and a different USB controller. + * Drivers for Windows 95, 98, Me and 2000 are available `here `_ (TODO: mirror this). Windows XP, Vista and 7 include drivers out of the box. + + +Socket 370 +---------- + +.. rubric:: A-Trend ATC7020BXII + +See: :ref:`atc6310bxii` + +.. rubric:: AEWIN AW-O671R + +* Equipped with dual Winbond W83977EF Super I/O chips driving four serial (COM1-COM4) and two parallel (LPT1-LPT2) ports. + + * The I/O ports and IRQs used by all these ports can be configured in the BIOS setup.