WESTERN DIGITAL
                UNIX STREAMS DRIVER FOR USE WITH
                "PLUS"-FAMILY LAN ADAPTER BOARDS

                       INSTALLATION GUIDE


INTRODUCTION

This driver provides a link layer interface for Western Digital 
"PLUS" (WD8003) family LAN adapter boards as specified in the
RELEASE.DOC file.

The driver uses STREAMS facilities and conforms to the AT&T LLI 
interface specification for STREAMS drivers.

Following is the procedure for installing the STREAMS driver for 
Western Digital "PLUS"-family LAN adapter boards on 80386-based 
computers operating under the UNIX (*) System V.3 operating 
system.  Because the information given is intended to be generic, 
you will need to use the file and path naming conventions 
specific to your UNIX V.3 system.

COPYING FILES

The UNIX V.3 STREAMS driver supplied on this disk is named wd.
To begin the installation, first log in to your system as root 
and make a directory for the driver with:

                  mkdir /etc/atconf/modules/wd

Next, place this DOS format driver disk into the computer's 
floppy disk drive and copy the files to the appropriate UNIX 
directories.  On INTERACTIVE Systems' 386/ix (*), this can be
done with the command:

                            dossette

to enter the DOS diskette subsystem.  Change to the subdirectory
of the driver disk containing the UNIX driver; for example:

             a:
             cd unix53

Copy the driver and configuration files into the appropriate 
UNIX directories by typing:

             get -b config /etc/atconf/modules/wd/config
             get -b space.c /etc/atconf/modules/wd/space.c
             get -b wd.o /etc/atconf/modules/wd/wd.o
             get -b wd.h /usr/include/sys/wd.h
             q

These commands assume that any required directories already 
exist, and copy the proper files into the appropriate 
directories.  If your system uses different naming or 
structural conventions for the directories, you will need to 
modify the newly created directories to be consistent with 
your system.

STREAMS DEVICE NUMBERS

To set the STREAMS device numbers for the Western Digital
LAN adapter device, use the following command:

                      mknod /dev/wd c 12 30

The number 12 is the STREAMS device number found in the config 
file for the clone driver in the /etc/atconf/modules/clone 
directory.

The number 30 is the STREAMS device number found in the newly 
created config file in the /etc/atconf/modules/wd directory. 
If no clone driver is available,  use "30  0" instead of 
"12  30" in setting the STREAMS device number.  This will create 
a minor device for a single process.  Add additional minor 
devices like "30  1" and "30  2" for additional processes if 
desired.

The number 30 can be changed if it conflicts with another device 
on your system.  Edit the wd/config file and change the 30 to a 
different major device number that is unused on your system.  
In addition, be sure to remember to change the 30 to the 
appropriate matching number in the mknod command.

If you wish to allow general access to the LAN adapter device, 
use the following command:

                        chmod 666 /dev/wd

ADAPTER BOARD CONFIGURATION PARAMETERS

Listed below are the software default settings for IRQ 
(interrupt), Base I/O Port, Base Shared Memory Address, and Board 
Size used by the LAN adapter board:

           IRQ = 3
           Base I/O Port = 0x280
           Base Shared Memory Address = 0xcc000
           Board Size = (8*1024)

The IRQ and Base I/O Port values correspond to the factory
default jumper settings for "PLUS"-family LAN adapter boards.
The Base Shared Memory Address is set entirely by software;
it is not affected by adapter board jumper settings.
The Board Size is the size of the on-board RAM on the adapter
used.

If these settings match those of the LAN adapter board you are 
using, you may continue with the installation procedures.  If 
the default values do not match those of the LAN adapter board, 
you must modify the config and space.c files.  The procedure 
for modifying these files is discussed below.

NOTE:  For Micro Channel bus adapters, the Base I/O Port, 
Base Shared Memory Address, Board Size, and IRQ values set in 
the space.c file are ignored.  The actual values used are those 
established for the adapter during the system configuration.
If the IRQ is being changed, only the "intvec" value must be 
modified in the config file.

The config and space.c files may be found on the driver disk in 
the unix53 directory, and will be installed in the 
/etc/atconf/modules/wd directory.  If you are going to change 
the IRQ, you must modify both the config and space.c files.  If 
you are going to change the Base I/O Port, Base Shared Memory 
Address, or Board Size you need only modify the space.c file.

To change the IRQ, edit the intvec = n parameter in the config 
file.  For AT bus machines, the value for n should be set based 
on the following values:

           INTVEC:   9    3    4    5    6    7

           IRQ:      2    3    4    5    6    7

For Micro Channel bus machines, the value for n should be set
based on the following values:

           INTVEC:   3    4    10    15

           IRQ:      3    4    10    15

Once the proper intvec value has been designated in the config 
file, edit the following line in the space.c file:

           #define WDIRQ            n

Set the value of n to the appropriate IRQ value.

To change the Base I/O Port, edit the following line in the 
space.c file:

           #define WDBASEPORT        0xn

Set the value of n to the appropriate Base I/O Port value.

To change the Base Shared Memory Address, edit the following 
line in the space.c file:

           #define WDBASEADDR        0xn

Set the value of n to the appropriate Base Shared Memory 
Address value.  

To change the Board Size (required to use the full 32K of RAM on
the WD8003EBT), edit the following line in the space.c file:

           #define WDBOARDSIZE       (n*1024)

Set the value of n to the appropriate number of Kilobytes in the
Board Size value.  

A new kernel must be built with the new values for IRQ, Base I/O
Port, Base Shared Memory Address and Board Size.  This new kernel 
must be booted before the new values become effective.

SYSTEMS FILES AND DIRECTORIES

Once the appropriate directories have been created and the 
proper files copied, you must edit the system.std file in 
the /etc/atconf/systems directory.

Add wd to the list of modules.  Also, if the clone version of
/dev/wd was used, make sure "clone" is in the list of modules.

BUILDING A NEW KERNEL

At this point, a new kernel must be built.  To do so, use the 
following command:

               mkunix -c /etc/atconf -s system.std

This command will create the unix.std.n file in the
/etc/atconf/kernels directory.  n is the incremented number of 
the new kernel.

To complete the installation of the Western Digital STREAMS 
driver, you must move and link the necessary files.  To do this,
use the following commands:

            mv /etc/atconf/kernels/unix.std.n  /

            mv /unix  /Ounix

            ln /unix.stn.n  /unix

Finally, shut down the system and then reboot.  When the system 
becomes operational, the wd STREAMS driver will be available for 
use.

(*) UNIX is a trademark of AT&T.