pcspeaker README.txt
May 4, 1999

pcspeaker is a simple driver that controls the internal speaker of PC-compatible machines.
 You can write data to this device to get crude audio out of your PC's speaker.

This project contains the following items:
article.txt		A newsletter article describing low-level timing issues in the BeOS.
driver/		Source for the pcspeaker driver
sine_test/		A simple test that outputs a sine wave -- use to test pcspeaker
README.txt	This file, of course!

This driver works with PC-compatible machines ONLY; PowerMacs and BeBoxen are not supported.



	Building pcspeaker

You can build pcspeaker with the makefile or BeIDE project file in driver/. Once you have build pcspeaker,
 go to the driver/ directory in Terminal and run:

install_pcspeaker

This is a simple script that will put the driver in the correct place and create the correct links for it.



	Building and running sine_test

Once you have installed the driver, build sine_test as you would any Be application (using the makefile
 or BeIDE project file in sine_test/). When you run sine_test, it will write raw data to the standard output;
 using the Terminal, you can redirect this output to pcspeaker to test the driver:

sine_test > /dev/audio/pcspeaker
