Installation/Use of the Ethernet Drivers

In the following discussion of the Ethernet drivers included with
your GG2-Bus+, the term <basename> will refer to the name of the 
device without the ".device" extenstion.

 
E.G.: The <basename> of "gg_ne1000.device" would be "gg_ne1000".

To install and use the drivers, copy the appropriate "<basename>.device" 
for your ethernet card to your "devs:networks" directory (Note: you must
create this directory if it does not all ready exist in your system).
Next, you must create a configuration file for your card.  

The name of the config file must be "<basename>.config_0 ", and it
must be put into your "envarc:sana2" directory.  The trailing 0 of the 
config file name means unit "0", as currently only one unit is supported.
You should also put the config file into your "env:sana2" directory in 
order to use the driver during your current session (all files in 
"envarc:" are copied to "env:" at bootup time).



How To Write Your Configuration File

The structure of the config file is really simple.  It contains infor-
mation about the jumper settings on your ethernet card for its IO address
and interrupt number.  The following rules apply:


*	No comments are supported.

*	The file is parsed as NAME<delimiter><ARGUMENT><delimiter> ...

*	Legal delimiters are Spaces, Tabs, '=' or newlines.

*	Numbers may be decimal ([0-9]+) or hexadecimal ('$'|'0x'|'0X')
	[0-9a-fA-F]+


Let's take as one example an ethernet card jumpered as PC-Interrupt 3 at 
PC-IO-Address $300: (refer to your ethernet card manual for how to set
the jumpers).  Your "env:sana2/<basename>.config_0" file should contain
the following line:

IRQ=3 IOADDR=0x300

The following formats are legal and mean the same thing:

IRQ 3 IOADDR 768
IRQ 0X3 IOADDR=$300
IOADDR=768 IRQ=0x3

Finally, once you have set up your configuration file correctly, you must 
update your TCP/IP network software to use "<basename>.device", unit "0". 
After this, you should be able to go on-line.