mirror of
https://github.com/alsa-project/alsa-tools.git
synced 2025-10-29 05:40:25 -04:00
e978fc745e
Major rewritten to use hwdep device instead of instrument layer. Also, more options (-c, -2, -q, -D) and better guess work for patch types now.
82 lines
2.6 KiB
Text
82 lines
2.6 KiB
Text
This is sbiload - an OPL2/3 FM instrument loader for ALSA hwdep
|
|
|
|
Written by Uros Bizjak <uros@kss-loka.si>
|
|
Web: http://www.kss-loka.si/~uros/sbiload.html
|
|
|
|
See the file COPYING for licence details.
|
|
|
|
Build and install
|
|
-----------------
|
|
|
|
You should be able to just type 'make'. All configuration variables
|
|
are in make.conf if you need to change anything.
|
|
|
|
By default it will install into /usr/local/bin, change INSTDIR in
|
|
make.conf to change this.
|
|
|
|
Usage
|
|
-----
|
|
|
|
sbiload [options] [instfile [drumfile]]
|
|
sbiload [options] -c
|
|
|
|
-D, --device=name - An ALSA hwdep name to use
|
|
-c, --clear - Clear patches and exit
|
|
-2 --opl2 - Two operators (OPL2) file type
|
|
-4 --opl3 - Four operators (OPL3) file type
|
|
-P, --path=path - Specify the patch path
|
|
-v, --verbose=level - Verbose level
|
|
-q, --quiet - Be quiet, no error/warning messages
|
|
-V, --version - Show version
|
|
|
|
When you have multiple sound cards and/or there may be multiple OPL2/3
|
|
synth devices, you have to tell sbiload which one to use, and pass its
|
|
hwdep name via -D option. Otherwise, sbiload will load the data onto
|
|
the first found device.
|
|
|
|
To find out the hwdep name of the OPL devices, check
|
|
/proc/asound/hwdep file first. It has the list of hwdep devices
|
|
currently available on your system.
|
|
|
|
% cat /proc/asound/hwdep
|
|
00-00: Emux WaveTable
|
|
00-01: OPL3 FM
|
|
01-00: OPL3 FM
|
|
|
|
In the example above, you have two OPL3 devices. To the first one
|
|
(00-01), which means the first card (00-) and the second device (01),
|
|
pass "-D hw:0,1". For the second OPL3 device (01-00), pass "-D
|
|
hw:1,0" instead.
|
|
|
|
For convenience, -D option accepts a string like /dev/snd/hwC0D3.
|
|
This is automatically parsed as "hw:0,3".
|
|
|
|
Running sbiload
|
|
---------------
|
|
|
|
Pass the instrument and drum file data as arguments.
|
|
|
|
% sbiload std.o3 drums.o3
|
|
|
|
Without a file type option (-2 or -4), sbiload will guess the file
|
|
type according to the hwdep iface type. If it's not correct, pass -2
|
|
or -4 option explicitly.
|
|
Also, when the given file isn't found, sbiload tries to load a file
|
|
with an appropriate extension, .sb for OPL2 and .o3 for OPL3.
|
|
|
|
You can omit the instrument and the drum file names, too. In this
|
|
case, the default file name "std" and "drums" are chosen.
|
|
|
|
The option -c is to mean just to clear patches and exit without
|
|
loading patches.
|
|
|
|
Acknowledgements
|
|
----------------
|
|
|
|
sbiload includes work from Steve Ratcliffe (pmidi-1.4.1.tar.gz) and
|
|
Jaroslav Kysela (alsamod-1999-09-01.tar.gz).
|
|
|
|
Where to report bugs and feedback
|
|
---------------------------------
|
|
|
|
Please report any problems to uros@kss-loka.si
|