Rewrite OPL2Board

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

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.