mirror/86Box-docs
1
0
Fork 0
mirror of https://github.com/86Box/docs.git synced 2026-02-22 01:25:34 -07:00
Code Issues Packages Projects Releases Wiki Activity

Rewrite OPL2Board

Browse Source
This commit is contained in:
RichardG867
2025-09-13 19:40:49 -03:00
parent e3a01879be
commit 2eaa877c8d
3 changed files with 12 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
hardware/externalopl.rst
View File

@@ -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 <settings/sound:Sound card #1-#4>` 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 <https://www.cheerful.nl/OPL2_Audio_Board/>`_ to a `supported Arduino board <https://github.com/DhrBaksteen/ArduinoOPL2/wiki/Connecting-the-OPL2-Audio-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 <settings/sound:Sound card #1-#4>`.
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.
.. 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.

1
index.rst
View File

@@ -50,6 +50,7 @@ Contents
hardware/ideterqua
hardware/network
hardware/isabugger
hardware/externalopl
.. toctree::
:maxdepth: 1

3
settings/sound.rst
View File

@@ -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 <https://github.com/nukeykt/Nuked-OPL3>`_ or `ymfm <https://github.com/aaronsgiles/ymfm>`_ library, per the :ref:`selection below <settings/sound:FM synth driver>`. MOS Technology 6581 SID emulation for the Innovation SSI-2001 and The Entertainer is provided by the reSIDfp component of the `libsidplayfp <https://github.com/libsidplayfp/libsidplayfp>`_ library. General Instrument AY-3-8913 emulation for the Mindscape Music Board is provided by the `Ayumi <http://sovietov.com/app/ayumi/ayumi.html>`_ 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 </hardware/externalopl:External OPL Audio Support>`.
The **YMOPL2Board** requires an external hardware device containing an OPL2 chip. See :doc:`../hardware/externalopl` for more information.
MIDI Out Device
---------------