Initial commit

[wrt350n-kernel.git] / Documentation / sound / oss / MultiSound

#! /bin/sh
#
#  Turtle Beach MultiSound Driver Notes
#  -- Andrew Veliath <andrewtv@usa.net>
#
#  Last update:                      September 10, 1998
#  Corresponding msnd driver:        0.8.3
#
# ** This file is a README (top part) and shell archive (bottom part).
#    The corresponding archived utility sources can be unpacked by
#    running `sh MultiSound' (the utilities are only needed for the
#    Pinnacle and Fiji cards). **
#
#
#  -=-=- Getting Firmware -=-=-
#  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#  
#  See the section `Obtaining and Creating Firmware Files' in this
#  document for instructions on obtaining the necessary firmware
#  files.
#  
#  
#  Supported Features
#  ~~~~~~~~~~~~~~~~~~
#  
#  Currently, full-duplex digital audio (/dev/dsp only, /dev/audio is
#  not currently available) and mixer functionality (/dev/mixer) are
#  supported (memory mapped digital audio is not yet supported).
#  Digital transfers and monitoring can be done as well if you have
#  the digital daughterboard (see the section on using the S/PDIF port
#  for more information).
#
#  Support for the Turtle Beach MultiSound Hurricane architecture is
#  composed of the following modules (these can also operate compiled
#  into the kernel):
#  
#  msnd               - MultiSound base (requires soundcore)
#
#  msnd_classic       - Base audio/mixer support for Classic, Monetery and
#                       Tahiti cards
#
#  msnd_pinnacle      - Base audio/mixer support for Pinnacle and Fiji cards
#  
#  
#  Important Notes - Read Before Using
#  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#  
#  The firmware files are not included (may change in future).  You
#  must obtain these images from Turtle Beach (they are included in
#  the MultiSound Development Kits), and place them in /etc/sound for
#  example, and give the full paths in the Linux configuration.  If
#  you are compiling in support for the MultiSound driver rather than
#  using it as a module, these firmware files must be accessible
#  during kernel compilation.
#
#  Please note these files must be binary files, not assembler.  See
#  the section later in this document for instructions to obtain these
#  files.
#  
#  
#  Configuring Card Resources
#  ~~~~~~~~~~~~~~~~~~~~~~~~~~
#
#  ** This section is very important, as your card may not work at all
#     or your machine may crash if you do not do this correctly. **
#
#  * Classic/Monterey/Tahiti
#  
#  These cards are configured through the driver msnd_classic.  You must
#  know the io port, then the driver will select the irq and memory resources
#  on the card.  It is up to you to know if these are free locations or now,
#  a conflict can lock the machine up.
#
#  * Pinnacle/Fiji
#
#  The Pinnacle and Fiji cards have an extra config port, either
#  0x250, 0x260 or 0x270.  This port can be disabled to have the card
#  configured strictly through PnP, however you lose the ability to
#  access the IDE controller and joystick devices on this card when
#  using PnP.  The included pinnaclecfg program in this shell archive
#  can be used to configure the card in non-PnP mode, and in PnP mode
#  you can use isapnptools.  These are described briefly here.
#
#  pinnaclecfg is not required; you can use the msnd_pinnacle module
#  to fully configure the card as well.  However, pinnaclecfg can be
#  used to change the resource values of a particular device after the
#  msnd_pinnacle module has been loaded.  If you are compiling the
#  driver into the kernel, you must set these values during compile
#  time, however other peripheral resource values can be changed with
#  the pinnaclecfg program after the kernel is loaded.
#
#
#  *** PnP mode
#  
#  Use pnpdump to obtain a sample configuration if you can; I was able
#  to obtain one with the command `pnpdump 1 0x203' -- this may vary
#  for you (running pnpdump by itself did not work for me).  Then,
#  edit this file and use isapnp to uncomment and set the card values.
#  Use these values when inserting the msnd_pinnacle module.  Using
#  this method, you can set the resources for the DSP and the Kurzweil
#  synth (Pinnacle).  Since Linux does not directly support PnP
#  devices, you may have difficulty when using the card in PnP mode
#  when it the driver is compiled into the kernel.  Using non-PnP mode
#  is preferable in this case.
#
#  Here is an example mypinnacle.conf for isapnp that sets the card to
#  io base 0x210, irq 5 and mem 0xd8000, and also sets the Kurzweil
#  synth to 0x330 and irq 9 (may need editing for your system):
#
#  (READPORT 0x0203)
#  (CSN 2)
#  (IDENTIFY *)
#  
#  # DSP
#  (CONFIGURE BVJ0440/-1 (LD 0
#          (INT 0 (IRQ 5 (MODE +E))) (IO 0 (BASE 0x0210)) (MEM 0 (BASE 0x0d8000))
#          (ACT Y)))
#  
#  # Kurzweil Synth (Pinnacle Only)
#  (CONFIGURE BVJ0440/-1 (LD 1
#          (IO 0 (BASE 0x0330)) (INT 0 (IRQ 9 (MODE +E)))
#          (ACT Y)))
#  
#  (WAITFORKEY)
#
#
#  *** Non-PnP mode
#  
#  The second way is by running the card in non-PnP mode.  This
#  actually has some advantages in that you can access some other
#  devices on the card, such as the joystick and IDE controller.  To
#  configure the card, unpack this shell archive and build the
#  pinnaclecfg program.  Using this program, you can assign the
#  resource values to the card's devices, or disable the devices.  As
#  an alternative to using pinnaclecfg, you can specify many of the
#  configuration values when loading the msnd_pinnacle module (or
#  during kernel configuration when compiling the driver into the
#  kernel).
#
#  If you specify cfg=0x250 for the msnd_pinnacle module, it
#  automatically configure the card to the given io, irq and memory
#  values using that config port (the config port is jumper selectable
#  on the card to 0x250, 0x260 or 0x270).
#
#  See the `msnd_pinnacle Additional Options' section below for more
#  information on these parameters (also, if you compile the driver
#  directly into the kernel, these extra parameters can be useful
#  here).
#
#
# ** It is very easy to cause problems in your machine if you choose a
#    resource value which is incorrect. **
#  
#
#  Examples
#  ~~~~~~~~
#  
#  * MultiSound Classic/Monterey/Tahiti:
#  
#  modprobe soundcore
#  insmod msnd
#  insmod msnd_classic io=0x290 irq=7 mem=0xd0000
#  
#  * MultiSound Pinnacle in PnP mode:
#  
#  modprobe soundcore
#  insmod msnd
#  isapnp mypinnacle.conf
#  insmod msnd_pinnacle io=0x210 irq=5 mem=0xd8000 <-- match mypinnacle.conf values
#  
#  * MultiSound Pinnacle in non-PnP mode (replace 0x250 with your configuration port,
#    one of 0x250, 0x260 or 0x270):
#  
#  insmod soundcore
#  insmod msnd
#  insmod msnd_pinnacle cfg=0x250 io=0x290 irq=5 mem=0xd0000
#  
# * To use the MPU-compatible Kurzweil synth on the Pinnacle in PnP
#   mode, add the following (assumes you did `isapnp mypinnacle.conf'):
#  
#  insmod sound
#  insmod mpu401 io=0x330 irq=9                    <-- match mypinnacle.conf values
#  
# * To use the MPU-compatible Kurzweil synth on the Pinnacle in non-PnP
#   mode, add the following.  Note how we first configure the peripheral's
#   resources, _then_ install a Linux driver for it:
#  
#  insmod sound
#  pinnaclecfg 0x250 mpu 0x330 9
#  insmod mpu401 io=0x330 irq=9
#
#  -- OR you can use the following sequence without pinnaclecfg in non-PnP mode:
#
#  insmod soundcore
#  insmod msnd
#  insmod msnd_pinnacle cfg=0x250 io=0x290 irq=5 mem=0xd0000 mpu_io=0x330 mpu_irq=9
#  insmod sound
#  insmod mpu401 io=0x330 irq=9
#
# * To setup the joystick port on the Pinnacle in non-PnP mode (though
#   you have to find the actual Linux joystick driver elsewhere), you
#   can use pinnaclecfg:
#
#   pinnaclecfg 0x250 joystick 0x200
#
#  -- OR you can configure this using msnd_pinnacle with the following:
#
#  insmod soundcore
#  insmod msnd
#  insmod msnd_pinnacle cfg=0x250 io=0x290 irq=5 mem=0xd0000 joystick_io=0x200
#
#  
#  msnd_classic, msnd_pinnacle Required Options
#  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#  
#  If the following options are not given, the module will not load.
#  Examine the kernel message log for informative error messages.
#  WARNING--probing isn't supported so try to make sure you have the
#  correct shared memory area, otherwise you may experience problems.
#  
#  io                   I/O base of DSP, e.g. io=0x210
#  irq                  IRQ number, e.g. irq=5
#  mem                  Shared memory area, e.g. mem=0xd8000
#  
#  
#  msnd_classic, msnd_pinnacle Additional Options
#  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#  
#  fifosize             The digital audio FIFOs, in kilobytes.  If not
#                       specified, the default will be used.  Increasing
#                       this value will reduce the chance of a FIFO
#                       underflow at the expense of increasing overall
#                       latency.  For example, fifosize=512 will
#                       allocate 512kB read and write FIFOs (1MB total).
#                       While this may reduce dropouts, a heavy machine
#                       load will undoubtedly starve the FIFO of data
#                       and you will eventually get dropouts.  One
#                       option is to alter the scheduling priority of
#                       the playback process, using `nice' or some form
#                       of POSIX soft real-time scheduling.
#
#  calibrate_signal     Setting this to one calibrates the ADCs to the
#                       signal, zero calibrates to the card (defaults
#                       to zero).
#  
#  
#  msnd_pinnacle Additional Options
#  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#
#  digital              Specify digital=1 to enable the S/PDIF input
#                       if you have the digital daughterboard
#                       adapter. This will enable access to the
#                       DIGITAL1 input for the soundcard in the mixer.
#                       Some mixer programs might have trouble setting
#                       the DIGITAL1 source as an input.  If you have
#                       trouble, you can try the setdigital.c program
#                       at the bottom of this document.
#
#  cfg                  Non-PnP configuration port for the Pinnacle
#                       and Fiji (typically 0x250, 0x260 or 0x270,
#                       depending on the jumper configuration).  If
#                       this option is omitted, then it is assumed
#                       that the card is in PnP mode, and that the
#                       specified DSP resource values are already
#                       configured with PnP (i.e. it won't attempt to
#                       do any sort of configuration).
#
#  When the Pinnacle is in non-PnP mode, you can use the following
#  options to configure particular devices.  If a full specification
#  for a device is not given, then the device is not configured.  Note
#  that you still must use a Linux driver for any of these devices
#  once their resources are setup (such as the Linux joystick driver,
#  or the MPU401 driver from OSS for the Kurzweil synth).
#
#  mpu_io               I/O port of MPU (on-board Kurzweil synth)
#  mpu_irq              IRQ of MPU (on-board Kurzweil synth)
#  ide_io0              First I/O port of IDE controller
#  ide_io1              Second I/O port of IDE controller
#  ide_irq              IRQ IDE controller
#  joystick_io          I/O port of joystick
#  
#  
#  Obtaining and Creating Firmware Files
#  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#  
#       For the Classic/Tahiti/Monterey
#       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
#  
#  Download to /tmp and unzip the following file from Turtle Beach:
#  
#       ftp://ftp.voyetra.com/pub/tbs/msndcl/msndvkit.zip
#  
#  When unzipped, unzip the file named MsndFiles.zip.  Then copy the
#  following firmware files to /etc/sound (note the file renaming):
#  
#    cp DSPCODE/MSNDINIT.BIN /etc/sound/msndinit.bin
#    cp DSPCODE/MSNDPERM.REB /etc/sound/msndperm.bin
#  
#  When configuring the Linux kernel, specify /etc/sound/msndinit.bin and
#  /etc/sound/msndperm.bin for the two firmware files (Linux kernel
#  versions older than 2.2 do not ask for firmware paths, and are
#  hardcoded to /etc/sound).
#
#  If you are compiling the driver into the kernel, these files must
#  be accessible during compilation, but will not be needed later.
#  The files must remain, however, if the driver is used as a module.
#  
#  
#       For the Pinnacle/Fiji
#       ~~~~~~~~~~~~~~~~~~~~~
#  
#  Download to /tmp and unzip the following file from Turtle Beach (be
#  sure to use the entire URL; some have had trouble navigating to the
#  URL):
#  
#       ftp://ftp.voyetra.com/pub/tbs/pinn/pnddk100.zip
#
#  Unpack this shell archive, and run make in the created directory
#  (you need a C compiler and flex to build the utilities).  This
#  should give you the executables conv, pinnaclecfg and setdigital.
#  conv is only used temporarily here to create the firmware files,
#  while pinnaclecfg is used to configure the Pinnacle or Fiji card in
#  non-PnP mode, and setdigital can be used to set the S/PDIF input on
#  the mixer (pinnaclecfg and setdigital should be copied to a
#  convenient place, possibly run during system initialization).
#
#  To generating the firmware files with the `conv' program, we create
#  the binary firmware files by doing the following conversion
#  (assuming the archive unpacked into a directory named PINNDDK):
#  
#    ./conv < PINNDDK/dspcode/pndspini.asm > /etc/sound/pndspini.bin
#    ./conv < PINNDDK/dspcode/pndsperm.asm > /etc/sound/pndsperm.bin
#  
#  The conv (and conv.l) program is not needed after conversion and can
#  be safely deleted.  Then, when configuring the Linux kernel, specify
#  /etc/sound/pndspini.bin and /etc/sound/pndsperm.bin for the two
#  firmware files (Linux kernel versions older than 2.2 do not ask for
#  firmware paths, and are hardcoded to /etc/sound).
#  
#  If you are compiling the driver into the kernel, these files must
#  be accessible during compilation, but will not be needed later.
#  The files must remain, however, if the driver is used as a module.
#
#  
#  Using Digital I/O with the S/PDIF Port
#  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#
#  If you have a Pinnacle or Fiji with the digital daughterboard and
#  want to set it as the input source, you can use this program if you
#  have trouble trying to do it with a mixer program (be sure to
#  insert the module with the digital=1 option, or say Y to the option
#  during compiled-in kernel operation).  Upon selection of the S/PDIF
#  port, you should be able monitor and record from it.
#
#  There is something to note about using the S/PDIF port.  Digital
#  timing is taken from the digital signal, so if a signal is not
#  connected to the port and it is selected as recording input, you
#  will find PCM playback to be distorted in playback rate.  Also,
#  attempting to record at a sampling rate other than the DAT rate may
#  be problematic (i.e. trying to record at 8000Hz when the DAT signal
#  is 44100Hz).  If you have a problem with this, set the recording
#  input to analog if you need to record at a rate other than that of
#  the DAT rate.
#
#
#  -- Shell archive attached below, just run `sh MultiSound' to extract.
#     Contains Pinnacle/Fiji utilities to convert firmware, configure
#     in non-PnP mode, and select the DIGITAL1 input for the mixer.
#
#
#!/bin/sh
# This is a shell archive (produced by GNU sharutils 4.2).
# To extract the files from this archive, save it to some FILE, remove
# everything before the `!/bin/sh' line above, then type `sh FILE'.
#
# Made on 1998-12-04 10:07 EST by <andrewtv@ztransform.velsoft.com>.
# Source directory was `/home/andrewtv/programming/pinnacle/pinnacle'.
#
# Existing files will *not* be overwritten unless `-c' is specified.
#
# This shar contains:
# length mode       name
# ------ ---------- ------------------------------------------
#   2046 -rw-rw-r-- MultiSound.d/setdigital.c
#  10235 -rw-rw-r-- MultiSound.d/pinnaclecfg.c
#    106 -rw-rw-r-- MultiSound.d/Makefile
#    141 -rw-rw-r-- MultiSound.d/conv.l
#   1472 -rw-rw-r-- MultiSound.d/msndreset.c
#
save_IFS="${IFS}"
IFS="${IFS}:"
gettext_dir=FAILED
locale_dir=FAILED
first_param="$1"
for dir in $PATH
do
  if test "$gettext_dir" = FAILED && test -f $dir/gettext \
     && ($dir/gettext --version >/dev/null 2>&1)
  then
    set `$dir/gettext --version 2>&1`
    if test "$3" = GNU
    then
      gettext_dir=$dir
    fi
  fi
  if test "$locale_dir" = FAILED && test -f $dir/shar \
     && ($dir/shar --print-text-domain-dir >/dev/null 2>&1)
  then
    locale_dir=`$dir/shar --print-text-domain-dir`
  fi
done
IFS="$save_IFS"
if test "$locale_dir" = FAILED || test "$gettext_dir" = FAILED
then
  echo=echo
else
  TEXTDOMAINDIR=$locale_dir
  export TEXTDOMAINDIR
  TEXTDOMAIN=sharutils
  export TEXTDOMAIN
  echo="$gettext_dir/gettext -s"
fi
touch -am 1231235999 $$.touch >/dev/null 2>&1
if test ! -f 1231235999 && test -f $$.touch; then
  shar_touch=touch
else
  shar_touch=:
  echo
  $echo 'WARNING: not restoring timestamps.  Consider getting and'
  $echo "installing GNU \`touch', distributed in GNU File Utilities..."
  echo
fi
rm -f 1231235999 $$.touch
#
if mkdir _sh01426; then
  $echo 'x -' 'creating lock directory'
else
  $echo 'failed to create lock directory'
  exit 1
fi
# ============= MultiSound.d/setdigital.c ==============
if test ! -d 'MultiSound.d'; then
  $echo 'x -' 'creating directory' 'MultiSound.d'
  mkdir 'MultiSound.d'
fi
if test -f 'MultiSound.d/setdigital.c' && test "$first_param" != -c; then
  $echo 'x -' SKIPPING 'MultiSound.d/setdigital.c' '(file already exists)'
else
  $echo 'x -' extracting 'MultiSound.d/setdigital.c' '(text)'
  sed 's/^X//' << 'SHAR_EOF' > 'MultiSound.d/setdigital.c' &&
/*********************************************************************
X *
X * setdigital.c - sets the DIGITAL1 input for a mixer
X *
X * Copyright (C) 1998 Andrew Veliath
X *
X * This program is free software; you can redistribute it and/or modify
X * it under the terms of the GNU General Public License as published by
X * the Free Software Foundation; either version 2 of the License, or
X * (at your option) any later version.
X *
X * This program is distributed in the hope that it will be useful,
X * but WITHOUT ANY WARRANTY; without even the implied warranty of
X * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
X * GNU General Public License for more details.
X *
X * You should have received a copy of the GNU General Public License
X * along with this program; if not, write to the Free Software
X * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
X *
X ********************************************************************/
X
#include <stdio.h>
#include <unistd.h>
#include <fcntl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/ioctl.h>
#include <sys/soundcard.h>
X
int main(int argc, char *argv[])
{
X       int fd;
X       unsigned long recmask, recsrc;
X
X       if (argc != 2) {
X               fprintf(stderr, "usage: setdigital <mixer device>\n");
X               exit(1);
X       }
X
X       if ((fd = open(argv[1], O_RDWR)) < 0) {
X               perror(argv[1]);
X               exit(1);
X       }
X
X       if (ioctl(fd, SOUND_MIXER_READ_RECMASK, &recmask) < 0) {
X               fprintf(stderr, "error: ioctl read recording mask failed\n");
X               perror("ioctl");
X               close(fd);
X               exit(1);
X       }
X
X       if (!(recmask & SOUND_MASK_DIGITAL1)) {
X               fprintf(stderr, "error: cannot find DIGITAL1 device in mixer\n");
X               close(fd);
X               exit(1);
X       }
X
X       if (ioctl(fd, SOUND_MIXER_READ_RECSRC, &recsrc) < 0) {
X               fprintf(stderr, "error: ioctl read recording source failed\n");
X               perror("ioctl");
X               close(fd);
X               exit(1);
X       }
X
X       recsrc |= SOUND_MASK_DIGITAL1;
X       
X       if (ioctl(fd, SOUND_MIXER_WRITE_RECSRC, &recsrc) < 0) {
X               fprintf(stderr, "error: ioctl write recording source failed\n");
X               perror("ioctl");
X               close(fd);
X               exit(1);
X       }
X
X       close(fd);
X       
X       return 0;
}
SHAR_EOF
  $shar_touch -am 1204092598 'MultiSound.d/setdigital.c' &&
  chmod 0664 'MultiSound.d/setdigital.c' ||
  $echo 'restore of' 'MultiSound.d/setdigital.c' 'failed'
  if ( md5sum --help 2>&1 | grep 'sage: md5sum \[' ) >/dev/null 2>&1 \
  && ( md5sum --version 2>&1 | grep -v 'textutils 1.12' ) >/dev/null; then
    md5sum -c << SHAR_EOF >/dev/null 2>&1 \
    || $echo 'MultiSound.d/setdigital.c:' 'MD5 check failed'
e87217fc3e71288102ba41fd81f71ec4  MultiSound.d/setdigital.c
SHAR_EOF
  else
    shar_count="`LC_ALL= LC_CTYPE= LANG= wc -c < 'MultiSound.d/setdigital.c'`"
    test 2046 -eq "$shar_count" ||
    $echo 'MultiSound.d/setdigital.c:' 'original size' '2046,' 'current size' "$shar_count!"
  fi
fi
# ============= MultiSound.d/pinnaclecfg.c ==============
if test -f 'MultiSound.d/pinnaclecfg.c' && test "$first_param" != -c; then
  $echo 'x -' SKIPPING 'MultiSound.d/pinnaclecfg.c' '(file already exists)'
else
  $echo 'x -' extracting 'MultiSound.d/pinnaclecfg.c' '(text)'
  sed 's/^X//' << 'SHAR_EOF' > 'MultiSound.d/pinnaclecfg.c' &&
/*********************************************************************
X *
X * pinnaclecfg.c - Pinnacle/Fiji Device Configuration Program
X *
X * This is for NON-PnP mode only.  For PnP mode, use isapnptools.
X *
X * This is Linux-specific, and must be run with root permissions.
X *
X * Part of the Turtle Beach MultiSound Sound Card Driver for Linux
X *
X * Copyright (C) 1998 Andrew Veliath
X *
X * This program is free software; you can redistribute it and/or modify
X * it under the terms of the GNU General Public License as published by
X * the Free Software Foundation; either version 2 of the License, or
X * (at your option) any later version.
X *
X * This program is distributed in the hope that it will be useful,
X * but WITHOUT ANY WARRANTY; without even the implied warranty of
X * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
X * GNU General Public License for more details.
X *
X * You should have received a copy of the GNU General Public License
X * along with this program; if not, write to the Free Software
X * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
X *
X ********************************************************************/
X
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <errno.h>
#include <unistd.h>
#include <asm/io.h>
#include <asm/types.h>
X
#define IREG_LOGDEVICE          0x07
#define IREG_ACTIVATE           0x30
#define LD_ACTIVATE             0x01
#define LD_DISACTIVATE          0x00
#define IREG_EECONTROL          0x3F
#define IREG_MEMBASEHI          0x40
#define IREG_MEMBASELO          0x41
#define IREG_MEMCONTROL         0x42
#define IREG_MEMRANGEHI         0x43
#define IREG_MEMRANGELO         0x44
#define MEMTYPE_8BIT            0x00
#define MEMTYPE_16BIT           0x02
#define MEMTYPE_RANGE           0x00
#define MEMTYPE_HIADDR          0x01
#define IREG_IO0_BASEHI         0x60
#define IREG_IO0_BASELO         0x61
#define IREG_IO1_BASEHI         0x62
#define IREG_IO1_BASELO         0x63
#define IREG_IRQ_NUMBER         0x70
#define IREG_IRQ_TYPE           0x71
#define IRQTYPE_HIGH            0x02
#define IRQTYPE_LOW             0x00
#define IRQTYPE_LEVEL           0x01
#define IRQTYPE_EDGE            0x00
X
#define HIBYTE(w)               ((BYTE)(((WORD)(w) >> 8) & 0xFF))
#define LOBYTE(w)               ((BYTE)(w))
#define MAKEWORD(low,hi)        ((WORD)(((BYTE)(low))|(((WORD)((BYTE)(hi)))<<8)))
X
typedef __u8                    BYTE;
typedef __u16                   USHORT;
typedef __u16                   WORD;
X
static int config_port = -1;
X
static int msnd_write_cfg(int cfg, int reg, int value)
{
X       outb(reg, cfg);
X       outb(value, cfg + 1);
X       if (value != inb(cfg + 1)) {
X               fprintf(stderr, "error: msnd_write_cfg: I/O error\n");
X               return -EIO;
X       }
X       return 0;
}
X
static int msnd_read_cfg(int cfg, int reg)
{
X       outb(reg, cfg);
X       return inb(cfg + 1);
}
X
static int msnd_write_cfg_io0(int cfg, int num, WORD io)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       if (msnd_write_cfg(cfg, IREG_IO0_BASEHI, HIBYTE(io)))
X               return -EIO;
X       if (msnd_write_cfg(cfg, IREG_IO0_BASELO, LOBYTE(io)))
X               return -EIO;
X       return 0;
}
X
static int msnd_read_cfg_io0(int cfg, int num, WORD *io)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       
X       *io = MAKEWORD(msnd_read_cfg(cfg, IREG_IO0_BASELO),
X                      msnd_read_cfg(cfg, IREG_IO0_BASEHI));
X
X       return 0;
}
X
static int msnd_write_cfg_io1(int cfg, int num, WORD io)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       if (msnd_write_cfg(cfg, IREG_IO1_BASEHI, HIBYTE(io)))
X               return -EIO;
X       if (msnd_write_cfg(cfg, IREG_IO1_BASELO, LOBYTE(io)))
X               return -EIO;
X       return 0;
}
X
static int msnd_read_cfg_io1(int cfg, int num, WORD *io)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       
X       *io = MAKEWORD(msnd_read_cfg(cfg, IREG_IO1_BASELO),
X                      msnd_read_cfg(cfg, IREG_IO1_BASEHI));
X
X       return 0;
}
X
static int msnd_write_cfg_irq(int cfg, int num, WORD irq)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       if (msnd_write_cfg(cfg, IREG_IRQ_NUMBER, LOBYTE(irq)))
X               return -EIO;
X       if (msnd_write_cfg(cfg, IREG_IRQ_TYPE, IRQTYPE_EDGE))
X               return -EIO;
X       return 0;
}
X
static int msnd_read_cfg_irq(int cfg, int num, WORD *irq)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       
X       *irq = msnd_read_cfg(cfg, IREG_IRQ_NUMBER);
X
X       return 0;
}
X
static int msnd_write_cfg_mem(int cfg, int num, int mem)
{
X       WORD wmem;
X
X       mem >>= 8;
X       mem &= 0xfff;
X       wmem = (WORD)mem;
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       if (msnd_write_cfg(cfg, IREG_MEMBASEHI, HIBYTE(wmem)))
X               return -EIO;
X       if (msnd_write_cfg(cfg, IREG_MEMBASELO, LOBYTE(wmem)))
X               return -EIO;
X       if (wmem && msnd_write_cfg(cfg, IREG_MEMCONTROL, (MEMTYPE_HIADDR | MEMTYPE_16BIT)))
X               return -EIO;
X       return 0;
}
X
static int msnd_read_cfg_mem(int cfg, int num, int *mem)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       
X       *mem = MAKEWORD(msnd_read_cfg(cfg, IREG_MEMBASELO),
X                       msnd_read_cfg(cfg, IREG_MEMBASEHI));
X       *mem <<= 8;
X
X       return 0;
}
X
static int msnd_activate_logical(int cfg, int num)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       if (msnd_write_cfg(cfg, IREG_ACTIVATE, LD_ACTIVATE))
X               return -EIO;
X       return 0;
}
X
static int msnd_write_cfg_logical(int cfg, int num, WORD io0, WORD io1, WORD irq, int mem)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       if (msnd_write_cfg_io0(cfg, num, io0))
X               return -EIO;
X       if (msnd_write_cfg_io1(cfg, num, io1))
X               return -EIO;
X       if (msnd_write_cfg_irq(cfg, num, irq))
X               return -EIO;
X       if (msnd_write_cfg_mem(cfg, num, mem))
X               return -EIO;
X       if (msnd_activate_logical(cfg, num))
X               return -EIO;
X       return 0;
}
X
static int msnd_read_cfg_logical(int cfg, int num, WORD *io0, WORD *io1, WORD *irq, int *mem)
{
X       if (msnd_write_cfg(cfg, IREG_LOGDEVICE, num))
X               return -EIO;
X       if (msnd_read_cfg_io0(cfg, num, io0))
X               return -EIO;
X       if (msnd_read_cfg_io1(cfg, num, io1))
X               return -EIO;
X       if (msnd_read_cfg_irq(cfg, num, irq))
X               return -EIO;
X       if (msnd_read_cfg_mem(cfg, num, mem))
X               return -EIO;
X       return 0;
}
X
static void usage(void)
{
X       fprintf(stderr,
X               "\n"
X               "pinnaclecfg 1.0\n"
X               "\n"
X               "usage: pinnaclecfg <config port> [device config]\n"
X               "\n"
X               "This is for use with the card in NON-PnP mode only.\n"
X               "\n"
X               "Available devices (not all available for Fiji):\n"
X               "\n"
X               "        Device                       Description\n"
X               "        -------------------------------------------------------------------\n"
X               "        reset                        Reset all devices (i.e. disable)\n"
X               "        show                         Display current device configurations\n"
X               "\n"
X               "        dsp <io> <irq> <mem>         Audio device\n"
X               "        mpu <io> <irq>               Internal Kurzweil synth\n"
X               "        ide <io0> <io1> <irq>        On-board IDE controller\n"
X               "        joystick <io>                Joystick port\n"
X               "\n");
X       exit(1);
}
X
static int cfg_reset(void)
{
X       int i;
X
X       for (i = 0; i < 4; ++i)
X               msnd_write_cfg_logical(config_port, i, 0, 0, 0, 0);
X       
X       return 0;
}
X
static int cfg_show(void)
{
X       int i;
X       int count = 0;
X
X       for (i = 0; i < 4; ++i) {
X               WORD io0, io1, irq;
X               int mem;
X               msnd_read_cfg_logical(config_port, i, &io0, &io1, &irq, &mem);
X               switch (i) {
X               case 0:
X                       if (io0 || irq || mem) {
X                               printf("dsp 0x%x %d 0x%x\n", io0, irq, mem);
X                               ++count;
X                       }
X                       break;
X               case 1:
X                       if (io0 || irq) {
X                               printf("mpu 0x%x %d\n", io0, irq);
X                               ++count;
X                       }
X                       break;
X               case 2:
X                       if (io0 || io1 || irq) {
X                               printf("ide 0x%x 0x%x %d\n", io0, io1, irq);
X                               ++count;
X                       }
X                       break;
X               case 3:
X                       if (io0) {
X                               printf("joystick 0x%x\n", io0);
X                               ++count;
X                       }
X                       break;
X               }
X       }
X
X       if (count == 0)
X               fprintf(stderr, "no devices configured\n");
X       
X       return 0;
}
X
static int cfg_dsp(int argc, char *argv[])
{
X       int io, irq, mem;
X
X       if (argc < 3 ||
X           sscanf(argv[0], "0x%x", &io) != 1 ||
X           sscanf(argv[1], "%d", &irq) != 1 ||
X           sscanf(argv[2], "0x%x", &mem) != 1)
X               usage();
X
X       if (!(io == 0x290 ||
X             io == 0x260 ||
X             io == 0x250 ||
X             io == 0x240 ||
X             io == 0x230 ||
X             io == 0x220 ||
X             io == 0x210 ||
X             io == 0x3e0)) {
X               fprintf(stderr, "error: io must be one of "
X                       "210, 220, 230, 240, 250, 260, 290, or 3E0\n");
X               usage();
X       }
X       
X       if (!(irq == 5 ||
X             irq == 7 ||
X             irq == 9 ||
X             irq == 10 ||
X             irq == 11 ||
X             irq == 12)) {
X               fprintf(stderr, "error: irq must be one of "
X                       "5, 7, 9, 10, 11 or 12\n");
X               usage();
X       }
X
X       if (!(mem == 0xb0000 ||
X             mem == 0xc8000 ||
X             mem == 0xd0000 ||
X             mem == 0xd8000 ||
X             mem == 0xe0000 ||
X             mem == 0xe8000)) {
X               fprintf(stderr, "error: mem must be one of "
X                       "0xb0000, 0xc8000, 0xd0000, 0xd8000, 0xe0000 or 0xe8000\n");
X               usage();
X       }
X
X       return msnd_write_cfg_logical(config_port, 0, io, 0, irq, mem);
}
X
static int cfg_mpu(int argc, char *argv[])
{
X       int io, irq;
X
X       if (argc < 2 ||
X           sscanf(argv[0], "0x%x", &io) != 1 ||
X           sscanf(argv[1], "%d", &irq) != 1)
X               usage();
X       
X       return msnd_write_cfg_logical(config_port, 1, io, 0, irq, 0);
}
X
static int cfg_ide(int argc, char *argv[])
{
X       int io0, io1, irq;
X
X       if (argc < 3 ||
X           sscanf(argv[0], "0x%x", &io0) != 1 ||
X           sscanf(argv[0], "0x%x", &io1) != 1 ||
X           sscanf(argv[1], "%d", &irq) != 1)
X               usage();
X       
X       return msnd_write_cfg_logical(config_port, 2, io0, io1, irq, 0);
}
X
static int cfg_joystick(int argc, char *argv[])
{
X       int io;
X
X       if (argc < 1 ||
X           sscanf(argv[0], "0x%x", &io) != 1)
X               usage();
X       
X       return msnd_write_cfg_logical(config_port, 3, io, 0, 0, 0);
}
X
int main(int argc, char *argv[])
{
X       char *device;
X       int rv = 0;
X
X       --argc; ++argv;
X
X       if (argc < 2)
X               usage();
X
X       sscanf(argv[0], "0x%x", &config_port);
X       if (config_port != 0x250 && config_port != 0x260 && config_port != 0x270) {
X               fprintf(stderr, "error: <config port> must be 0x250, 0x260 or 0x270\n");
X               exit(1);
X       }
X       if (ioperm(config_port, 2, 1)) {
X               perror("ioperm");
X               fprintf(stderr, "note: pinnaclecfg must be run as root\n");
X               exit(1);
X       }
X       device = argv[1];
X
X       argc -= 2; argv += 2;
X
X       if (strcmp(device, "reset") == 0)
X               rv = cfg_reset();
X       else if (strcmp(device, "show") == 0)
X               rv = cfg_show();
X       else if (strcmp(device, "dsp") == 0)
X               rv = cfg_dsp(argc, argv);
X       else if (strcmp(device, "mpu") == 0)
X               rv = cfg_mpu(argc, argv);
X       else if (strcmp(device, "ide") == 0)
X               rv = cfg_ide(argc, argv);
X       else if (strcmp(device, "joystick") == 0)
X               rv = cfg_joystick(argc, argv);
X       else {
X               fprintf(stderr, "error: unknown device %s\n", device);
X               usage();
X       }
X
X       if (rv)
X               fprintf(stderr, "error: device configuration failed\n");
X       
X       return 0;
}
SHAR_EOF
  $shar_touch -am 1204092598 'MultiSound.d/pinnaclecfg.c' &&
  chmod 0664 'MultiSound.d/pinnaclecfg.c' ||
  $echo 'restore of' 'MultiSound.d/pinnaclecfg.c' 'failed'
  if ( md5sum --help 2>&1 | grep 'sage: md5sum \[' ) >/dev/null 2>&1 \
  && ( md5sum --version 2>&1 | grep -v 'textutils 1.12' ) >/dev/null; then
    md5sum -c << SHAR_EOF >/dev/null 2>&1 \
    || $echo 'MultiSound.d/pinnaclecfg.c:' 'MD5 check failed'
366bdf27f0db767a3c7921d0a6db20fe  MultiSound.d/pinnaclecfg.c
SHAR_EOF
  else
    shar_count="`LC_ALL= LC_CTYPE= LANG= wc -c < 'MultiSound.d/pinnaclecfg.c'`"
    test 10235 -eq "$shar_count" ||
    $echo 'MultiSound.d/pinnaclecfg.c:' 'original size' '10235,' 'current size' "$shar_count!"
  fi
fi
# ============= MultiSound.d/Makefile ==============
if test -f 'MultiSound.d/Makefile' && test "$first_param" != -c; then
  $echo 'x -' SKIPPING 'MultiSound.d/Makefile' '(file already exists)'
else
  $echo 'x -' extracting 'MultiSound.d/Makefile' '(text)'
  sed 's/^X//' << 'SHAR_EOF' > 'MultiSound.d/Makefile' &&
CC      = gcc
CFLAGS  = -O
PROGS   = setdigital msndreset pinnaclecfg conv
X
all: $(PROGS)
X
clean:
X       rm -f $(PROGS)
SHAR_EOF
  $shar_touch -am 1204092398 'MultiSound.d/Makefile' &&
  chmod 0664 'MultiSound.d/Makefile' ||
  $echo 'restore of' 'MultiSound.d/Makefile' 'failed'
  if ( md5sum --help 2>&1 | grep 'sage: md5sum \[' ) >/dev/null 2>&1 \
  && ( md5sum --version 2>&1 | grep -v 'textutils 1.12' ) >/dev/null; then
    md5sum -c << SHAR_EOF >/dev/null 2>&1 \
    || $echo 'MultiSound.d/Makefile:' 'MD5 check failed'
76ca8bb44e3882edcf79c97df6c81845  MultiSound.d/Makefile
SHAR_EOF
  else
    shar_count="`LC_ALL= LC_CTYPE= LANG= wc -c < 'MultiSound.d/Makefile'`"
    test 106 -eq "$shar_count" ||
    $echo 'MultiSound.d/Makefile:' 'original size' '106,' 'current size' "$shar_count!"
  fi
fi
# ============= MultiSound.d/conv.l ==============
if test -f 'MultiSound.d/conv.l' && test "$first_param" != -c; then
  $echo 'x -' SKIPPING 'MultiSound.d/conv.l' '(file already exists)'
else
  $echo 'x -' extracting 'MultiSound.d/conv.l' '(text)'
  sed 's/^X//' << 'SHAR_EOF' > 'MultiSound.d/conv.l' &&
%%
[ \n\t,\r]
\;.*
DB
[0-9A-Fa-f]+H   { int n; sscanf(yytext, "%xH", &n); printf("%c", n); }
%%
int yywrap() { return 1; }
main() { yylex(); }
SHAR_EOF
  $shar_touch -am 0828231798 'MultiSound.d/conv.l' &&
  chmod 0664 'MultiSound.d/conv.l' ||
  $echo 'restore of' 'MultiSound.d/conv.l' 'failed'
  if ( md5sum --help 2>&1 | grep 'sage: md5sum \[' ) >/dev/null 2>&1 \
  && ( md5sum --version 2>&1 | grep -v 'textutils 1.12' ) >/dev/null; then
    md5sum -c << SHAR_EOF >/dev/null 2>&1 \
    || $echo 'MultiSound.d/conv.l:' 'MD5 check failed'
d2411fc32cd71a00dcdc1f009e858dd2  MultiSound.d/conv.l
SHAR_EOF
  else
    shar_count="`LC_ALL= LC_CTYPE= LANG= wc -c < 'MultiSound.d/conv.l'`"
    test 141 -eq "$shar_count" ||
    $echo 'MultiSound.d/conv.l:' 'original size' '141,' 'current size' "$shar_count!"
  fi
fi
# ============= MultiSound.d/msndreset.c ==============
if test -f 'MultiSound.d/msndreset.c' && test "$first_param" != -c; then
  $echo 'x -' SKIPPING 'MultiSound.d/msndreset.c' '(file already exists)'
else
  $echo 'x -' extracting 'MultiSound.d/msndreset.c' '(text)'
  sed 's/^X//' << 'SHAR_EOF' > 'MultiSound.d/msndreset.c' &&
/*********************************************************************
X *
X * msndreset.c - resets the MultiSound card
X *
X * Copyright (C) 1998 Andrew Veliath
X *
X * This program is free software; you can redistribute it and/or modify
X * it under the terms of the GNU General Public License as published by
X * the Free Software Foundation; either version 2 of the License, or
X * (at your option) any later version.
X *
X * This program is distributed in the hope that it will be useful,
X * but WITHOUT ANY WARRANTY; without even the implied warranty of
X * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
X * GNU General Public License for more details.
X *
X * You should have received a copy of the GNU General Public License
X * along with this program; if not, write to the Free Software
X * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
X *
X ********************************************************************/
X
#include <stdio.h>
#include <unistd.h>
#include <fcntl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/ioctl.h>
#include <sys/soundcard.h>
X
int main(int argc, char *argv[])
{
X       int fd;
X
X       if (argc != 2) {
X               fprintf(stderr, "usage: msndreset <mixer device>\n");
X               exit(1);
X       }
X
X       if ((fd = open(argv[1], O_RDWR)) < 0) {
X               perror(argv[1]);
X               exit(1);
X       }
X
X       if (ioctl(fd, SOUND_MIXER_PRIVATE1, 0) < 0) {
X               fprintf(stderr, "error: msnd ioctl reset failed\n");
X               perror("ioctl");
X               close(fd);
X               exit(1);
X       }
X
X       close(fd);
X       
X       return 0;
}
SHAR_EOF
  $shar_touch -am 1204100698 'MultiSound.d/msndreset.c' &&
  chmod 0664 'MultiSound.d/msndreset.c' ||
  $echo 'restore of' 'MultiSound.d/msndreset.c' 'failed'
  if ( md5sum --help 2>&1 | grep 'sage: md5sum \[' ) >/dev/null 2>&1 \
  && ( md5sum --version 2>&1 | grep -v 'textutils 1.12' ) >/dev/null; then
    md5sum -c << SHAR_EOF >/dev/null 2>&1 \
    || $echo 'MultiSound.d/msndreset.c:' 'MD5 check failed'
c52f876521084e8eb25e12e01dcccb8a  MultiSound.d/msndreset.c
SHAR_EOF
  else
    shar_count="`LC_ALL= LC_CTYPE= LANG= wc -c < 'MultiSound.d/msndreset.c'`"
    test 1472 -eq "$shar_count" ||
    $echo 'MultiSound.d/msndreset.c:' 'original size' '1472,' 'current size' "$shar_count!"
  fi
fi
rm -fr _sh01426
exit 0