
Installation
------------
For detailed instructions on how to install the RM Ethernet AT Adapter, refer
to the document "RM Ethernet-16 Card, Installation Supplement", a copy of which
has been supplied. By default, the adaptor is set to use base port address
0x300, interrupt request level 3, and the cheapernet connector.

If a single instance of the RM Ethernet AT MAC driver is required, then the
ADAPTORADDRESS keyword may be omitted from the PROTOCOL.INI file. If more than
one instance of the driver is required, then each section in PROTOCOL.INI must
contain an ADAPTORADDRESS keyword indicating the base port address of the
required adaptor.

Note that the first instance of the RM Ethernet AT MAC driver adopts the driver
name RMETH$. Subsequent instances adopt the names RMETH1$ to RMETH3$. The
relevant section in the PROTOCOL.INI file is identified by means of the
parameter to the DRIVERNAME keyword.


Trouble Shooting
----------------
The RM Ethernet MAC driver may produce any one of a number of messages at load
time. The possible messages and their meanings are listed below.

MAC1001E: Protocol Manager not found

The RM Ethernet MAC driver failed to open the device PROTMAN$. Check that the
Protocol Manager has been correctly loaded before the MAC driver.

MAC1003E: Initialization Error

The RM Ethernet MAC driver failed to register with the Protocol Manager.

MAC1004W: PROTOCOL.INI keyword error := <keyword>

The RM Ethernet MAC driver has encountered an unrecognized keyword in the
relevant section of the PROTOCOL.INI file. Check that PROTOCOL.INI contains
only keywords which are described in the relevant README.INI file.

MAC1005W: PROTOCOL.INI parameter error := <parameter>

The RM Ethernet MAC driver has encountered a bad parameter for one of the
keywords in the relevant section of the PROTOCOL.INI file. Check that
PROTOCOL.INI contains only keyword parameters which are described in the
relevant README.INI file.

MAC1006W: PROTOCOL.INI DRIVER parameters not found

The RM Ethernet MAC driver has failed to locate the relevant section in the
PROTOCOL.INI file. Check that the relevant section is present, and has the
correct DRIVERNAME parameter.

In order to conform to NDIS 2.0, the RM Ethernet MAC does not access the
hardware until bind time. If a hardware fault is detected, then the MAC driver
returns a suitable error code to the Protocol Manager, and this will result in
the bind failing with a hardware error message. If this occurs, check that the
adaptor has been correctly installed as described in the relevant README.INI
file. In particular, for the RM Ethernet AT card, check that no conflicts exist
with other adaptors.


PROTOCOL.INI Parameters
=======================

The RM Ethernet AT MAC driver accepts the following keywords
in the PROTOCOL.INI file:


MAXREQUESTS
-----------
This keyword accepts a single numeric parameter which defines the number of
requests which can be queued by the MAC driver. The possible range of values
for the parameter 1 to 10. A default value of 6 is used if the keyword is
omitted.


MAXTRANSMITS
------------
This keyword accepts a single numeric parameter which defines the number of
transmit requests which can be queued by the MAC driver. The possible range of
values for the parameter is 1 to 50. A default value of 6 is used if the
keyword is omitted.


ADAPTORADDRESS
--------------
This keyword accepts a single numeric parameter which specifies the base port
address of the adaptor. For the AT adaptor, possible values for the parameter
are 0x300, 0x320, 0x340 and 0x360. The base port address for the adaptor is
defined by means of jumpers. Details of setting the base port address are
contained in the attached documentation.

If this keyword is omitted, then the driver will attempt to automatically
detect the base port address of the adaptor. The keyword should only be omitted
if only a single instance of the MAC driver is loaded.

Note that it is not necessary to specify other hardware parameters such as the
interrupt request level, since these are determined automatically by the MAC
driver.

All adaptors are configured to use base port address 0x300 and interrupt
request level 3 by default.


STATIONADDRESS
--------------
This keyword accepts a single textual parameter which defines the network
address to be used by the MAC driver. This parameter should be a twelve-digit
hexadecimal number. If this keyword is omitted, then the unique network address
which is hard-wired onto the adapter is used.


DRIVERNAME
----------
This keyword accepts a single textual parameter which specifies the name of the
MAC driver character device. This parameter is used by the MAC driver to
identify the relevant section in PROTOCOL.INI, and so may not be omitted.

It is possible to load more than one instance of the MAC driver. The first
instance will adopt the name RMETH$. Subsequent instances will adopt names
RMETH1$ to RMETH3$. A maximum of four instances may be loaded, and each must
have a unique ADAPTORADDRESS parameter in PROTOCOL.INI.

