PSGXBIOS v0.7 2023-01-21
========================

What is this:

 - it's an OS-level approximation of the YM2149 used in the Atari ST series
   of computers.
 - if you miss the familiar keyboard click, this program is for you.
 - This is not a perfect YM2149 emulator, nor is it designed to be. This is a
   zero-overhead approximation on the OS-level. It doesn't magically implement
   any missing hardware registers, hence any application using those will fail
   miserably even with this software.


System Requirements (for now):

 - Apollo Vampire V4 (tested on SA)
 - A TOS-compatible operating system.
 - Somewhat Atari-compatible interrupts (VBL at 0x70, TC at 0x114)

Installation:

It's a TSR. Just slip it into \AUTO\ or mint.cnf.

Technical Details:

The program use Pamela channels 0-2 to emulate the three square. The shared
noise channel is emulated using Pamela channel 3. Envelopes are emulated by
constantly re-evaluating volume levels on register writes and in the TC-
interrupt handler. This means envelopes won't generate any nice side effects
and stuff like buzzers etc won't work.

The program (re)implements Giaccess(), Dosound(), Ongibit() and Offgibit().

That's it! Knock yourself out. Feel free to use this software any way you
like, just don't blame me if something goes wrong. I should normally not 
be trusted with computers; I can make them crash just by looking at them.
Imagine that super power with a compiler, making binaries, and putting
those binaries in your computer. But hey - whatever floats your boat.

-- Peter Persson

(a.k.a. Shoggoth on the Vampire Discord, or pep.fishmoose@gmail.com)