PSG AY-3-8910 RT MSX SDCC Library (fR3eL Project)

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

---

Description

Library for access to internal or external MSX PSG AY-3-8910 in Real Time.

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

Reading or writing to the PSG is done through calls to the assigned ports.

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+, Flashjacks or other).

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!

---

History of versions

• v1.6 (07/06/2021) Fixes problem with reading the registers in the MEGAFLASHROM SCC++
• v1.5 (09/05/2021) External AY
• v1.4 (17/06/2018) Corrected a BUG in the SOUND function. Change name function Sound to SOUND.
• v1.3 (11/02/2018) Revised and first publication.
• v1.2 (?) ?
• v1.1 (14/02/2014) Initial version.
• v1.0 (?) ?

---

Requirements

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

---

Acknowledgments

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 >> ?