The programs in this directory are more or less incompletely implemented.
I have used them for debugging purposes while developing the driver.
Files in this directory:
../ultrasound.h (sys/ultrasound.h)
This file contains some macros which are similar than
the procedures provided by GUSUNIT.PAS. See gustest.c
for more information.
INSTALL THIS FILE TO YOUR /usr/include/sys !!!!!!!!!!!!
gusload.c This program can be used to load patches (samples) to
the DRAM of GUS. It understands the format used in the
.pat files shipped with GUS.
Usage: gusload pgm# patchfile.
or gusload reset #Removes all patches from memory.
You should load just the patches you will need to play
a Midi file, since the memory capacity of GUS is rather
limited (256k-1M).
Example:
gusload 0 acpiano.pat
gusload 1 britepno.pat
gusload 19 church.pat
This program is not required if the adagio package is
used. It can do the patch uploading itself.
gmod.c This is a simple module player which demonstrates
programming with GUS. It doesn't try to interpret
most of the effect commands. In fact this program
may interpret the modules incorrectly since I am
not a module player expert.
This version plays .MOD, .STM and .669 modules.
midithru.c This program reads messages from the Midi interface
and plays the notes with an internal synthesizer
(FM or GUS). The program accepts one argument, the
synthesizer device number. In addition to the note on
and note off messages it interprets also program changes
and channel pressure messages.
If you need an example on programming the /dev/sequencer,
this is a good one. The voice allocation algorithm is
not good so don't look at it.
NOTE! This program is useful with gmod. Jus load
a module with gmod. Wait until the module has
finished or hit ^C. Now you can play the samples
with the midithru program.
NOTE2! You need a Midi keyboard to use this program. In
addition the Midi interface of GUS is not supported
yet which means you need also PAS16 or MPU-401.
pmtest.c
gpatinfo.c ******* For information only *******
These programs demonstrate the patch manager interface
which will be included to some later driver version.
This interface is not complete in version 1.99.9.
Using pmtest will hang your system sooner or later.
Hannu Savolainen
hsavolai@cs.helsinki.fi
6b8afe4d37