Copyright (c) 2022 Mark Feldman (aka "Myndale").

This project is a re-creation of an old sound demo from the 80s which played digitized audio out the PC speaker. The music itself was from an Australian television commercial for "Magic Mushroom" air fresheners (see https://www.youtube.com/watch?v=BfGsjGHSKww).

What was impressive about the Magic Mushroom demo...and others like it...was that the speaker in the original IBM PC wasn't designed to play digitized audio. The PC's Programmable Interval Timer (or "PIT") chip had three timers, and the digital output of one of them (timer 2) was connected to the speaker. By setting the timer for Square Wave mode you could generate a single continuous square wave tone.

What the Magic Mushroom demo did was reprogram timer 2 for one-shot mode instead, and instead of outputting a voltage proportional to each sample (i.e. "pulse code modulation") it instead output a pulse whose length was proportional to the sample ("pulse width modulation"). The result is surprisingly decent digitized audio playing from the PC speaker. The only other thing you have to do is make sure you send samples at the correct playback speed, and for that you can simply program PIT timer 0 to generate an interrupt at the desired frequency and trigger the timer 2 one-shot in the interrupt handler.

A potential side-effect of this technique is that depending on the quality of the speaker and drive circuitry, you may hear an overlaid sinusoidal waveform at the playback frequency. Magic Mushroom got around this by simply doubling the playback frequency, playing each sample twice and letting the poor response curve of the tiny speaker filter this much higher-frequency signal out. I tried implementing this fix in this demo but couldn't hear any difference in DosBox, so I've left it out for now (it's very easy to put back in of course).

The precompiled executable in this package runs fine in DosBox. If you want to build it yourself then you'll need Borland C++ 3.1, keeping in mind that it won't run within the Borland IDE itself (the huge memory allocation fails, and I can't rememeber how I used to get around it). The audio file is simply an array of unsigned bytes, I generated it by ripping the ad off YouTube and converting it with ffmpeg:

	ffmpeg -i mushroom.webm -f u8 -acodec pcm_u8 -ac 1 -ar 9000 MUSHROOM.OVL

All-in-all this is a surprisingly simple trick to pull off, and one that doesn't even require any assembly!