This code should compile cleanly in any environment that has C++17 support. It has been tested on gcc, clang, and Microsoft Visual C++ 2019.
Supported chip families
Currently, support is present for the following chips (organized by header file):
- YM2151 (OPM)
- YM2164 (OPP)
- YM2149 (SSG)
- YM2203 (OPN)
- YM2608 (OPNA)
- YM2610 (OPNB)
- YM2610B (OPNB2)
- YM2612 (OPN2)
- YM3438 (OPN2C)
- YMF276 (OPN2L)
- YM3526 (OPL)
- Y8950 (MSX-Audio)
- YM3812 (OPL2)
- YMF262 (OPL3)
- YMF278B (OPL4) -- partial (only the FM side)
- YM2413 (OPLL)
- YM2423 (OPLL-X)
- YMF281 (OPLLP)
- DS1001 (Konami 053982)
- YM3806 (OPQ) -- preliminary
- YM2414 (OPZ) -- preliminary
Check out the examples directory for some example usage patterns. I'm not a big fan of makefiles for simple things, so instructions on how to compile each example are provided at the top.
The general philosophy of the emulators provided here is that they are clock-independent. Much like the actual chips, you (the consumer) control the clock; the chips themselves have no idea what time it is. They just tick forward each time you ask them to.
The way you move things along is via the
generate() function, which ticks the internal system forward one or more samples, and writes out an array out chip-specific
output_data. But what, exactly, is a "sample", and how long is it?
This is where the external clock comes in. Most of the Yamaha chips are externally clocked in the MHz range. They then divide that clock by a factor (sometimes dynamically controllable), and then the internal operators are pipelined to further divide the clock.
For example, the YM2151 internally divides the clock by 2, and has 32 operators to iterate through. Thus, for a nominal input lock of 3.58MHz, you end up at around a 55.9kHz sample rate. Fortunately, all the chip implementations can compute this for you; just pass the raw external clock value to the
sample_rate() method and it will hand you back the output sample rate you want.
generate() that many times per second to output the results.
But what if I want to output at a "normal" rate, like 44.1kHz? Sorry, you'll have to rate convert as needed.
Reading and Writing
To read or write to the chips, you can call the
write() methods. The offset provided corresponds to the addressing input lines in a (hopefully) logical way.
For reads, almost all chips have a status register, which you can read via
read_status(). Some chips have a data port that can be read via
read_data(). And chips with extended addressing may also have
For writes, almost all chips have an address register and a data register, and so you can reliably count on there being a
write_data() method as well. If the chip supports extended addressing, it may also have