From 2eaa877c8d6e05443208dc361d02e76e690c7c97 Mon Sep 17 00:00:00 2001 From: RichardG867 Date: Sat, 13 Sep 2025 19:40:49 -0300 Subject: [PATCH] Rewrite OPL2Board --- hardware/externalopl.rst | 23 ++++++++++------------- index.rst | 1 + settings/sound.rst | 3 +-- 3 files changed, 12 insertions(+), 15 deletions(-) diff --git a/hardware/externalopl.rst b/hardware/externalopl.rst index 19950af..bdbe363 100644 --- a/hardware/externalopl.rst +++ b/hardware/externalopl.rst @@ -1,19 +1,16 @@ -External OPL Audio Support -========================== +External OPL audio +================== -86Box now supports the **OPL2Board** as an external audio device. -This allows users to connect a real OPL2 (YM3812) chip through the board and use it alongside the emulator for authentic FM synthesis output. +The **YMOPL2Board** :ref:`sound card ` allows for a real Yamaha OPL2 (YM3812) chip to be connected to the emulated machine for authentic FM synthesis output. Usage ----- -1. Connect your OPL2Board to the host system. -2. Select the sound card **[ISA] OPL2Board [External Device]**. -3. In the **Configure** button, select the serial port to which the board is connected. +1. Connect the `OPL2 Audio Board from Cheerful Electronic `_ to a `supported Arduino board `_. +2. Connect the Arduino board to the host system. +3. Select the **YMOPL2Board (External Device)** sound card on the :ref:`emulated machine's configuration `. +4. Use the *Configure* button to select the Arduino's serial port. -Notes for OPL2Board -------------------- - -- You need an **Arduino Nano** and an **OPL2Board** from Cheerful Electronic. -- Follow the **instructions from the manufacturer** and upload ``SerialPassthrough.ino`` to the Arduino Nano. -- If you want **PCM audio**, you can add an **additional sound card** and disable the OPL output. \ No newline at end of file +.. note:: + * The **OPL3 Duo!** board is currently not supported. + * Regular **PCM/wave audio** still requires an emulated sound card to be configured. If the emulated sound card provides its own OPL, it can often be **muted** through a mixer utility within the machine. diff --git a/index.rst b/index.rst index e1f7d01..46bfe5c 100644 --- a/index.rst +++ b/index.rst @@ -50,6 +50,7 @@ Contents hardware/ideterqua hardware/network hardware/isabugger + hardware/externalopl .. toctree:: :maxdepth: 1 diff --git a/settings/sound.rst b/settings/sound.rst index 0bfcb28..92474d8 100644 --- a/settings/sound.rst +++ b/settings/sound.rst @@ -16,8 +16,7 @@ The *Configure* button opens a new window with settings specific to the selected Emulation for the Yamaha OPL series of synthesizers (used by many of the emulated cards) is provided by a modified `Nuked OPL3 `_ or `ymfm `_ library, per the :ref:`selection below `. MOS Technology 6581 SID emulation for the Innovation SSI-2001 and The Entertainer is provided by the reSIDfp component of the `libsidplayfp `_ library. General Instrument AY-3-8913 emulation for the Mindscape Music Board is provided by the `Ayumi `_ library. -You can also select an external OPL sound card by choosing the sound cards that have **(External Device)** at the end of their name. -See more information in the :ref:`External OPL audio device documentation `. +The **YMOPL2Board** requires an external hardware device containing an OPL2 chip. See :doc:`../hardware/externalopl` for more information. MIDI Out Device ---------------