Author: mvac7
Architecture: MSX
Format: C Object (SDCC .rel)
Programming language: C and Z80 assembler

Library functions for access to internal or external MSX PSG AY-3-8910.

It does not use the BIOS so it can be used to program both ROMs or MSX-DOS executables.

This library is similar to the PSG AY-3-8910 RT, but instead of writing directly to the registers, it does so to a buffer that should be dumped to the AY in each VBLANK frame.

It is designed to work together with the PT3player and/or ayFXplayer libraries, but you can also use it for your own or third-party player.

In this same repository you will find a short version (AY38910BF_S) with the essentials to work with player libraries.

It incorporates the SOUND function with the same behavior as the command included in MSX BASIC, as well as specific functions to modify the different sound parameters of the AY.

Controls the I/O bits of register 7 (Mixer), of the internal AY.

It allows to use the internal PSG of the MSX or an external one (like the one incorporated in the MEGAFLASHROM SCC+ or the Flashjacks).

In the header file there is a definition of SWITCHER type, needed for the functions. This type uses the values "ON" or "OFF", which equals 1 and 0 respectively.

Include definitions to improve the readability of your programs.

Use them for developing MSX applications using Small Device C Compiler (SDCC).

This project is an Open Source library. You can add part or all of this code in your application development or include it in other libraries/engines.

You can access the documentation here with How to use the library.

In the source code examples/, you can find applications for testing and learning purposes.

This library is part of the MSX fR3eL Project.

Enjoy it!

• v0.9b (07 July 2021) First version (Based in AY-3-8910 RT Library)

• Small Device C Compiler (SDCC) v4.1
• Hex2bin v2.5

I want to give a special thanks to all those who freely share their knowledge with the MSX developer community.

• Avelino Herrera > WEB
• Nerlaska > Blog
• Marq > Marq
• MSXKun/Paxanga soft > WEB
• Fubukimaru gitHub
• Andrear > Blog
• Sapphire/Z80ST > WEB
• Fernando García > Video Tutorial
• Ramones > MSXblog - MSXbanzai
• Eric Boez > gitHub
• MSX Assembly Page > WEB
• Portar MSX Tech Doc > WEB
• MSX Resource Center > WEB
• Karoshi MSX Community > WEB
• BlueMSX emulator >> WEB
• OpenMSX emulator >> WEB
• WebMSX emulator by Paulo A. Peccin >> gitHub
• fMSX emulator by Marat Fayzullin WEB
• Meisei emulator by Hap >> ?