SRND Version 1.3
================


Step 1: Plug & Play setup
-------------------------

  Since the miroMEDIA Surround board is a Plug & Play card, it has to
  be initialized after power on. There are several ways to do this:


  a) Boot DOS or Windows with the miroMEDIA Surround drivers and reboot
     to Linux.


  b) Let the BIOS do the Plug & Play setup.


  c) Use the ISA PnP tools for linux.

     The ISA PnP tools are programs to configure ISA Plug & Play devices
     on a Linux machine. For further information and the latest version of
     the ISA PnP tools see:

     http://www.roestock.demon.co.uk/isapnptools/

     The entry in the "/etc/isapnp.conf" file for the miroMEDIA Surround board
     should look like this:

     (CONFIGURE MIR5752/1343357200 (LD 0
     #     ANSI string -->SURROUND<--
     (IO 0 (SIZE 1) (BASE 0x0300))
     (ACT Y)
     ))


  d) Use the native ISA Plug & Play support of the Linux kernel.

     Since version 2.4.x the Linux kernel has native Plug & Play support for
     ISA cards. To use this the kernel has to be compiled with the options
     CONFIG_PNP=y and CONFIG_ISAPNP=y.

     The advantage of this procedure is that you don't have to take care of
     the base address used by the Surround board. The SRND module gets the
     address to be used directly from the kernel's PnP driver.


Step 2: Build and install the kernel module
-------------------------------------------

  You must have the loadable module support enabled in your running
  kernel (CONFIG_MODULES=y).

  You must have the kernel sources installed (usually in "/usr/src/linux").

  Type the following:

  % tar xvzf srnd-1.3.tar.gz     # Unpack the sources
  % cd ./srnd-1.3                # Change directory
  % vi Makefile                  # Read and modify the Makefile
  % su root                      # Become root
  % make                         # Build the module
  % make install                 # Create inodes and install driver files
  % make modprobe                # Load the module into the kernel


Step 3: Build and install the command line tool (optional)
----------------------------------------------------------

  % cd ./srndt                   # Change into srndt directory
  % vi Makefile                  # Read and modify the Makefile
  % make                         # Build the tool
  % su root                      # Become root (if you are not already)
  % make install                 # Install the tool


Step 4: Automatic module loading
--------------------------------

  Notice that you always have to install the kernel module with
  "modprobe srnd io=0x300" before you can use this driver. Alternatively
  you may want the kernel daemon (resp. Kmod with kernel versions 2.2.x or
  higher) to do that for you. Here is how to do that:

    1. Modify the file "/etc/conf.modules". Here is an example of the lines
       which need to be added:

       alias char-major-110 srnd
       options srnd io=0x300

       This will load the SRND module with I/O port 0x300 used for the board.

       With native ISA Plug & Play support build into the kernel you can
       omit the line "options srnd io=0x300".

    2. Do a "depmod -a" to update the module dependencies.

  Please read the Module-HOWTO for details about kernel modules and kerneld.
  For information about Kmod take a look at linux/Documentation/kmod.txt.


Makefile options
----------------

In the Makefile of the driver there are these entries of interest:

  SRND_MAJOR := 110
        This is the major device number for the SRND device.
        Since this is the official allocated major character device number
        for the miroMEDIA Surround board, this should not be changed without
        any good reason.

  SRND_MAXDEV := 4
        This is the maximum number of miroMEDIA Surround boards that can
	be used with the driver at one time.
        I don't know if it is possible to use more than one board in one PC.

  SRND_DEFIO := 0x300
        This is the default base port address used for the miroMEDIA Surround
	board, if no I/O ports are given as parameters to the module. You can
	also use the value 0 for autodetection of the address.

  SRND_INCLUDE := /usr/local/include
        This is the location where the srnd include file srnd.h will be
        installed.

  SRND_MANDIR := /usr/local/man
        This is the location where the manual pages reside.

  SRND_MANSEC := 4
        This is the section where the manual page will be installed.
	The default is 4 (Devices).

  KERNEL_LOCATION := /usr/src/linux
	This is the location where the kernel sources reside.


Notes
-----

  After installation of this driver you should install a graphical control
  panel for it. For available panels take a look at:

  http://www.tu-bs.de/~y0000441/srnd_e.html


Copyright (C) 1998-2001 Oliver Gantz <Oliver.Gantz@ePost.de>.
