Subversion Repositories or1k

Installation
------------

IMPORTANT!      Read this if you are installing a separately
                distributed version of this driver.

                Check that your kernel version works with this
                release of the driver (see Readme). Also verify
                that your current kernel version doesn't have more
                recent sound driver version than this one. IT'S HIGHLY
                RECOMMENDED THAT YOU USE THE SOUND DRIVER VERSION THAT
                IS DISTRIBUTED WITH KERNEL SOURCES.

- When installing separately distributed sound driver you should first
  read the above notice. Then try to find proper directory where and how
  to install the driver sources. You should not try to install a separately
  distributed driver version if you are not able to find the proper way
  yourself (in this case use the version that is distributed with kernel
  sources). Remove old version of linux/drivers/sound directory before
  installing new files.

- To build the device files you need to run the enclosed shell script 
  (see below). You need to do this only when installing sound driver
  first time or when upgrading to much recent version than the earlier
  one.

- Configure and compile Linux as normally (remember to include the
  sound support during "make config"). Please refer to kernel documentation
  for instructions about configuring and compiling kernel. File Readme.cards
  contains card specific instructions for configuring this driver for
  use with various sound cards.

Boot time configuration (using lilo and insmod) 
-----------------------------------------------

This information has been removed. Too many users didn't believe
that it's really not necessary to use this method. Please look at
Readme of sound driver version 3.0.1 if you still want to use this method.

Problems
--------

If you have any kind of problems, there is a debugging feature which
could help you to solve the problem. To use it, just execute the
command:

        cat /dev/sndstat 

and look at the output. It should display some useful info about the
driver configuration. If there is no /dev/sndstat 
(/dev/sndstat: No such file or directory), ensure that you have executed the
soundinstall script (at the end of this file).

Common error messages:

- /dev/???????: No such file or directory.
Run the script at the end of this file.

- /dev/???????: No such device.
You are not running kernel which contains the sound driver. When using
modularized sound driver this error means that the sound driver is not
loaded.

- /dev/????: No such device or address.
Sound driver didn't detect suitable card when initializing. Please look at
Readme.cards for info about configuring the driver with your card. Also
check for possible boot (insmod) time error messages in /var/adm/messages.

- Other messages or problems
Please check http://www.4front-tech.com/ossfree for more info.

Hannu Savolainen
hannu@4front-tech.com

----------------- cut here ------------------------------
#!/bin/sh
echo Error: Read the notice in the beginning of this script before executing.
exit -1
Notice! Remove this notice and the above two lines before trying to execute.
        Trying to run this script is normally useless. The device files are
        almost certainly already set up correctly. 
# *****************************************
# * NOTICE!
# *
# * For security reasons read access to /dev/dsp* and /dev/audio* has been
# * disabled from other than root. Otherwise any user may be able to spy
# * what is being talked about near the microphone.
# * This effectively disables audio recording by other than root. In case
# * this capability is required, you should change AUDIOPERMS (below) to 666
# * before executing this script.
# *****************************************
AUDIOPERMS=622
#
#
#
#
# Create the devices
#
#       Mixer devices
#
if [ -e /dev/mixer ]; then 
        rm -f /dev/mixer 
fi

if [ -e /dev/mixer0 ]; then 
        rm -f /dev/mixer0 
fi
 
mknod -m 666 /dev/mixer0 c 14 0
ln -sf /dev/mixer0 /dev/mixer

if [ -e /dev/mixer1 ]; then 
        rm -f /dev/mixer1 
fi
mknod -m 666 /dev/mixer1 c 14 16


#       Sequencer       (14, 1)
#
if [ -e /dev/sequencer ]; then
        rm -f /dev/sequencer
fi
mknod -m 666 /dev/sequencer c 14 1

if [ -e /dev/patmgr0 ]; then
        rm -f /dev/patmgr0
fi
mknod -m 666 /dev/patmgr0 c 14 17
if [ -e /dev/patmgr1 ]; then
        rm -f /dev/patmgr1
fi
mknod -m 666 /dev/patmgr1 c 14 33

        #       music   (14, 8)
        #
        if [ -e /dev/music ]; then
                rm -f /dev/music
        fi

        mknod -m 666 /dev/music c 14 8
        if [ -e /dev/sequencer2 ]; then
                rm -f /dev/sequencer2
        fi
        ln -s /dev/music /dev/sequencer2

#       Midi devices
#
if [ -e /dev/midi ]; then
        rm -f /dev/midi         # Old name. Don't use it
fi
        if [ -e /dev/midi00 ]; then
                rm -f /dev/midi00
        fi
        mknod -m 666 /dev/midi00 c 14 2
        ln -sf /dev/midi00 /dev/midi
        
        if [ -e /dev/midi01 ]; then
                rm -f /dev/midi01
        fi
        mknod -m 666 /dev/midi01 c 14 18
        
        if [ -e /dev/midi02 ]; then
                rm -f /dev/midi02
        fi
        mknod -m 666 /dev/midi02 c 14 34
        
        if [ -e /dev/midi03 ]; then
                rm -f /dev/midi03
        fi
        mknod -m 666 /dev/midi03 c 14 50
#
#       DSP             (14, 3)
#
if [ -e /dev/dsp ]; then
        rm -f /dev/dsp
fi
if [ -e /dev/dsp0 ]; then
        rm -f /dev/dsp0
fi
mknod -m $AUDIOPERMS /dev/dsp0 c 14 3
ln -s /dev/dsp0 /dev/dsp

#
#       DSPW            (14, 5)
#
if [ -e /dev/dspW ]; then
        rm -f /dev/dspW
fi
if [ -e /dev/dspW0 ]; then
        rm -f /dev/dspW0
fi
mknod -m $AUDIOPERMS /dev/dspW0 c 14 5
ln -s /dev/dspW0 /dev/dspW

if [ -e /dev/dspW1 ]; then
        rm -f /dev/dspW1
fi
mknod -m $AUDIOPERMS /dev/dspW1 c 14 37

#
#       SPARC compatible /dev/audio     (14, 4) 
#
if [ -e /dev/audio ]; then
        rm -f /dev/audio
fi
if [ -e /dev/audio0 ]; then
        rm -f /dev/audio0
fi
mknod -m $AUDIOPERMS /dev/audio0 c 14 4
ln -s /dev/audio0 /dev/audio

#
#       DSP1            (14, 19) /dev/dsp for the second soundcard.
#                               Also the SB emulation part of the
#                               PAS16 card.
#
if [ -e /dev/dsp1 ]; then
        rm -f /dev/dsp1
fi
mknod -m $AUDIOPERMS /dev/dsp1 c 14 19
#
#       SPARC audio1    (14, 20) 
#                               /dev/audio for the second soundcard.
#                               Also the SB emulation part of the
#                               PAS16 card.
#
if [ -e /dev/audio1 ]; then
        rm -f /dev/audio1
fi
mknod -m $AUDIOPERMS /dev/audio1 c 14 20
#
#       /dev/sndstat    (14,6)  For debugging purposes
#
if [ -e /dev/sndstat ]; then
        rm -f /dev/sndstat
fi
mknod -m 666 /dev/sndstat c 14 6
exit 0