SYNC570.LAN v 2.00.05 

Note:  This driver provides limited support for PCI adapters -- specifically,
       it supports SYNC/570ip adapters in "legacy" mode (ie: all memory
       regions on the card are mapped below 1 Megabyte).

Installation instructions for the SYNC570.LAN driver.

The installation of the WHSM driver for the Digi International SYNC/570
and SYNC/570i boards is very simple.

This release contains two files --

        SYNC570.LAN
        SYNC570.LDI

Copy these files to the SYSTEM directory of your Novell Server.

At this point you may want to install the driver into MPR.  This driver
works with both MPR 3.1 and MPR 3.0.

To install the driver first load INETCFG.NLM on the system console.

When INETCFG.NLM is loaded select the "Boards" option.

This will bring up a list of lan and wan adapters currently installed
on your system.

Press the "Insert" key to bring up a list of available drivers.

Part way down the screen should be a driver titled "SYNC570".  Select
that.

The next screen is the Board Configuration Screen.

You must enter a Board Name.

Select the PCI Board number from the following list --

	    0, 1, 2, 3, 4, 5, 6, 7

    Note:  To use an ISA card, specify a PCI Board number of 0 and 
           set the remaining parameters accordingly.  To use a PCI
           card, specify 1 - 7.  The remaining parameters are unused
           by the driver.  It gets this information from the PCI BIOS
           Configuration Space for each adapter.  The remaining para-
           meters may be set to any value.

Then select your desired interupt level from the following list --

            3, 5, 7, A, B, C, F

Select an IO Port address (whichever one you selected when you
installed the adapter card in the system) from the following list --

            100, 110, 120, 130, 140, 150, 160, 170
            180, 190, 1a0, 1b0, 1c0, 1d0, 1e0, 1f0
            200, 210, 220, 230, 240, 250, 260, 270
            280, 290, 2a0, 2b0, 2c0, 2d0, 2e0, 2f0
            300, 310, 320, 330, 340, 350, 360, 370
            380, 390, 3a0, 3b0, 3c0, 3d0, 3e0, 3f0

Select an unused Memory address for the host adapter --

            A0000, A4000, A8000, AC000, B0000, B4000
            B8000, BC000, C0000, C4000, C8000, CC000
            D0000, D4000, D8000, DC000, E0000, E4000
            E8000, EC000, F0000, F4000, F8000, FC000
            C00000, C40000, C80000, CC0000
            D00000, D40000, D80000, DC0000
            E00000, E40000, E80000, EC0000
            F00000, F40000, F80000, FC0000

The comment field is irrelevant.

For a Micro Channel board the only option to select is the board
Slot.  Select the slot number where the Micro Channel version of
the SYNC/570 is located.   All other parameters are determined by
the POS utility.

Press "Escape" and select "Yes" and the board will be installed.

See the Novell MPR 3.1 manual for details on configuration of the
Network Interface, Protocols, Bindings and other options.

One important item to note is that the configuration assumes a 4
port board.  If a 2 port board has been installed the user should
simply not enable the last two ports.  Enabling non-existent ports
can result in problems including operating systems ABENDs.

The load line for the board will be added by INETCFG automatically.

The syntax for the line is ....

        load SYNC570.LAN pbrd=w port=xxx mem=yyyyy int=z channel=a name=syn_1

		note:  for "pbrd=w" a value of 0 means it is an ISA card, and a value
		of 1 - 7 means it is PCI card 1 - 7.

or, for a Micro Channel machine, its ....

        load SYNC570.LAN slot=1 channel=a name=sync570_1

When the system is rebooted if the driver does not initialize correctly
one of the following errors may be generated.

SYNC570: PCI Adapter has resource mapped above 1 Meg.  Adapter skipped.

	The current version of the driver functions with cards which are
        running in legacy mode (ie: all memory resources are mapped below
        1 Megabyte.)  Future versions of the driver will remove this
        restriction.  The offending PCI adapter is not made available to
        the driver.

SYNC570: PCI Adapter (Device ID = XXXX) -- revision must be 1 or greater.
         Adapter skipped.

	Revision 0 of the SYNC/570ip boards cannot be used with this driver.
        You must have revision 1 or greater.

SYNC570: Fatal Error: Invalid PCI Board Number or Board not usable.

        An adapter board number was specified that exceeds the number of 
        PCI adapters the driver has detected and determined to be usable.

SYNC570: Fatal Error: Duplicate Memory Address.

        Another adapter has already registered the configured
        SYNC/570 memory address.  Please select another address.

SYNC570: Fatal Error: Maximum Number of Boards exceeded.

        There driver is capable of supporting a maximum of four
        SYNC/570 adapters.  That limit has been exceeded.

SYNC570: Fatal Error: Config File Not Found, Exiting

        The Name= parameter of the board load line has not
        been configured.  Check to see that the driver load line
        (ex. "load SYNC570.LAN port=120 mem=d8000 int=5 channel=1 name=fred")
        is the same as the configured board.

SYNC570: Fatal Error: Incorrect Major or Minor Version Numbers.

        The Major and Minor version numbers of the TSM are
        invalid.  Check your MPR 3.1 installation.

SYNC570: Fatal Error: TSM Port Registered Error.

        Registration with the TSM failed.  Check to see
        that the TSM has loaded.  Check the board configuration.

SYNC570: Fatal Error: Bad Channel/Line No Param.

        An invalid channel number has been selected.  An example
        would be trying to install channel 3 of a 2 port board.
        Check your board installation.

SYNC570: Fatal Error: Channel already in use.

        The selected channel has already been configured.

SYNC570: Fatal Error: SNMP Registration Failed.

        The SNMP support was unable to register.

SYNC570: Fatal Error: No Port Addr Param.

        The port address was not included on the command line.
        Make sure a port=xxx parameter is included on the load
        line.

SYNC570: Fatal Error: Unable to register with WSM.

        The WAN board (the SYNC/570 driver specifically) was unable
        to register with the upper levels of the protocol stack.
        Check the board configuration.

SYNC570: Fatal Error: Unable to Initialize Board.

        Board initialization failed.  Run diags on the board.

SYNC570: Fatal Error: Unable to Initialize Port.

        Port Initialization failed.  Check for a bad board.
        Check port configuration in INETCFG.

SYNC570: Fatal Error: Unable to get TSM entries.

        The driver was unable to get the TSM entry points.  Check
        board and port configuration along with MPR installation.

SYNC570: Fatal Error: Unable to get resource tag.

        The driver attempted to allocate a resource tag and failed.

SYNC570: Fatal Error: Unable to get memory.

        The driver was unable to allocate memory for internal usage.

SYNC570: Fatal Error: Parse Driver Parameter.

        Invalid parameters were selected on the load line.  Please
        check the load line for accuracy.

SYNC570: Fatal Error: A null pointer was passed as an initialization parameter

        The board was unable to be initialized.

SYNC570: Fatal Error: The initialization parameter is out of range

        An attempt was made to initialize the board with a parameter
        that was invalid.

SYNC570: Fatal Error: The Board is already initialized

        The driver has been called twice for the same board and
        port combination.

SYNC570: Fatal Error: The initialization parameter is in error

        An attempt was made to initialize the board with an
        incorrect parameter.

SYNC570: Fatal Error: Memory for the board could not be allocated

        The driver was unable to allocated memory for internal
        functions.

SYNC570: Fatal Error: Board RAM failed the memory test.

        A memory test has been executed on the SYNC/570 and
        this test has failed.  Please check that there are
        no other adapters trying to use the selected memory
        address.  This may indicated board failure.

SYNC570: Fatal Error: The board cannot be found at IO port.

        The board does not appear to be at that IO port.  Please
        check your dipswitch settings.

SYNC570: Fatal Error: The board memory address conflicts with system memory.

        The SYNC/570 has been configured to be at an already
        allocated memory address.  Please select another address.

There are a handful of warnings that may occur.  Please check your
configuration if these occur.

SYNC570: WARNING: Config Record Error, Using Defaults.
SYNC570: WARNING: Config File Not Found, Using Defaults.

        If either of these errors occur then check the configuration
        of the driver and the load line that is installing it.

SYNC570: WARNING: Maximum Packet Size smaller than Configured MRU Size using smaller value.

        The Maximum internal packet size is smaller that the size configured.
        The lesser of the two values is being used.
