        Hewlett-Packard ISA SCO LLI 3.11 Driver Update

This file explains how to prepare and install the HP ISA SCO LLI 3.11
Driver Update.  Other sections of this file describe removing the
update and explanations of error messages produced by the driver.

This update is intended to replace the HPI driver on the SCO LLI Driver
disk collection versions 3.0 and 3.1.  Later versions of the SCO LLI
Driver disk already have this driver.

Installing this update will preserve all current HP ISA LLI adapter
configurations and NETCONFIG chains.  Removing the update will restore
the original HPI driver.

NOTE: Do not remove the current hpi driver either before or after the
      update!  Doing so will damage the update and prevent restoration
      if the update is removed.

This update incorporates two changes to the HP EtherTwist ISA LLI driver:
    1) Support for HP LAN Adapter/16 Plus TP and TL (HP 27247B
       and HP 27252A) in both I/O and memory mapped transfer modes.
    2) Extra transmit packet caching in adapter memory.  This can
       improve transmit throughput without any increase in CPU
       utilization.

This updated HP ISA LLI driver continues to support the following
adapters:
    - HP LAN Adapter/8  TP (HP 27245)
    - HP LAN Adapter/8  TL (HP 27250)
    - HP LAN Adapter/16 TP (HP 27247A)

The SCO operating systems supported are:
    - SCO Unix versions 3.2v1, 3.2v2, and 3.2v4
    - SCO Open Desktop versions 1.0, 1.1, 2.0, and 3.0
    - SCO Multiprocessor Extension versions 1.0, 1.1, 2.0, and 3.0

The SCO networking products supported are:
    - SCO TCP/IP versions 1.1.3 and 1.2
    - SCO NFS versions 1.1.1 and 1.2
    - Microsoft LAN Manager for Unix 1.x and 2.x
    - Retix OSI version 1.0 and 2.0
    - SCO IPX/SPX version 1.0.2

The HPI driver can support four LAN adapters.  If more than one HP/16 Plus
will be installed, see the HP/16 Plus Installation Guide section
"Configuring Multiple Adapters in the Same Computer" for the correct
procedure.

The Memory-Mapped mode of the HP/16 Plus delivers the best performace.
Please read the "Using Memory-Mapped Mode" in the HP/16 Plus Installation
Guide and the file \MEMMAP.DOC on this support disk.

To install the HP/16 Plus and the HPI driver update, follow the
instructions below:

1.  Install the HP/16 Plus adapter(s) into the computer.

    If you are installing the HP/16 Plus in an EISA computer, run the
    computer's EISA configuration utility first before installing the
    HP/16 Plus.  See "Note for EISA Computers" at the end of this file for
    directions.

    Follow the HP/16 Plus Installation Guide and the computer documentation
    for the correct procedure to install an I/O adapter into the computer.
    Ensure that power has been disconnected from the computer before opening
    the computer's case.


2.  Configure and test the HP/16 Plus.

    Reconnect power to the computer and boot DOS.  Run the HP configurator
    on the HP Support Disk.  For example, if the Support Disk is in floppy
    drive A, execute the following commands at the DOS prompt:

        A:
        HPLANSET

    Select "Auto Configuration" to let HPLANSET choose available I/O
    Address Range, and Interrupt Channel values.  Write down these
    values for later use.

    NOTE: Auto configuration does not work if more than one HP/16 Plus is
          installed.  See the HP/16 Plus guide section "Configuring Multiple
          Adapters in the Same Computer" for the correct procedure.

    Enter the "Manual Configuration" menu and select the option "I/O or
    Memory mapped".  When the menu appears, choose an address that is
    available.

    NOTE: For EISA computers, use the address selected in step D in the
          "Note for EISA Computers" instructions.

    Select "Card Test" to verify the adapter.  After it passes, select
    "Save configuration to card" and then "Exit program".

    Connect the LAN cable to the HP/16 Plus.


3.  Reboot the computer into the SCO operating system's System
    Maintenance (single user) mode.


4.  Copy the driver update file from the DOS HP Support Disk to a Unix
    file using the doscp(C) command.  For example, if floppy drive 0
    contains the 5.25-inch 1.2 Mbyte HP Support Disk, run:

         doscp -r /dev/fd0:/sco_unix/hpi311.z /tmp/hpi311.Z

    OR, if floppy drive 0 contains the 3.5-inch 720 Kbyte HP Support
    Disk, run:

         doscp -r /dev/fd0135ds9:/sco_unix/hpi311.z /tmp/hpi311.Z

    Note, the uppercase Z extension in the filename /tmp/hpi311.Z is
    necessary so the update can be uncompressed.


5.  Uncompress the update, run the Unix command uncompress(C):

         uncompress /tmp/hpi311.Z


6.  Format a blank diskette that is large enough to contain the driver
    update using the format(C) command.  For example, if floppy drive
    0 is for 5.25-inch 1.2 MByte diskettes, run:

         format /dev/rfd096ds15

    OR, if floppy drive 0 is for 3.5-inch 1.44 MByte diskettes, run:

         format /dev/rfd0135ds18


7.  Use the dd(C) command to transfer the uncompressed driver update
    file to the newly formatted diskette.  For example, if floppy
    drive 0 is for 5.25-inch 1.2 MByte diskettes, run:

         dd if=/tmp/hpi311 of=/dev/fd096ds15

    OR, if floppy drive 0 is for 3.5-inch 1.44 MByte diskettes, run:

         dd if=/tmp/hpi311 of=/dev/fd0135ds18


8.  Run `custom'.  Then:
    A. Select `Install'.
    B. Select `A New Product'.
    C. Select `Entire Product'.
    D. Allow custom to complete the install process successfully.
    E. Exit custom.


  +----------------------------------------------------------------+
  | If no new HP ISA LAN Adapters were installed, skip to step 12  |
  | of these instructions.                                         |
  |                                                                |
  | If any new HP LAN Adapters are to be used by SCO TCP/IP,       |
  | perform steps 9 and 10 of these instructions.                  |
  |                                                                |
  | If the new HP LAN Adapters are to be used only by Microsoft    |
  | LAN Manager for Unix, Retix OSI, or SCO IPX/SPX, skip to       |
  | step 11.                                                       |
  +----------------------------------------------------------------+

9.  Run `mkdev hpi'.  Select add and enter the adapter configuration
    parameters at each prompt.  See "Note on HP/16 Plus LLI Parameters"
    below.  Do not relink the kernel.

10. Run `mkdev tcp'.  Select driver hpi and enter the network
    parameters at each prompt.  Do not relink the kernel.

  +----------------------------------------------------------------+
  | If the new HP LAN Adapters are also to be used by Microsoft    |
  | LAN Manager for Unix, Retix OSI, or SCO IPX/SPX, then perform  |
  | step 11, otherwise, skip to step 12.                           |
  +----------------------------------------------------------------+

11. Run `netconfig'.  Select create chain and enter selections at each
    prompt.  Select driver hpi as the last element in each chain.
    Enter the adapter configuration parameters if prompted for them.
    See "Note on HP/16 Plus LLI Parameters" section below.  Do not relink
    the kernel.

12. Change directory to /etc/conf/cf.d and run the Unix command:

         ./link_unix -y

13. Reboot the SCO operating system and watch the boot messages from
    driver hpi for each HP ISA LAN Adapter to verify all adapter
    configuration parameters are correct.



Note on HPI Parameters
======================
When configuring an adapter for the HPI to use, the MKDEV or NETCONFIG
utilities will prompt for adapter parameters.  The first prompt will
ask which model of adapter is to be configured.  This will allow the 
succeeding prompts to display only the choices appropriate for the
adapter.  

    Enter the type of HP ISA LAN Adapter to be configured.
    a) Adapter/8           (HP 27245 or HP 27250)
    b) Adapter/16          (HP 27247A)
    c) Adapter/16 Plus     (HP 27227B or HP 27252A)
    d) Any of the above    (any HP ISA LAN adapter)
    Enter adapter type (a b c d) [d] or 'q' to quit:

Enter the letter denoting the adapter to be configured.  The choice 'd'
will select a subset that is appropriate for all the above adapters.

All the prompts will display the legal choices between the parentheses
and the default between the square brackets.  To select the default,
press the ENTER key.  At any prompt, the letter 'q' will abort the
utility without making any changes.

The next two prompts are for the Interrupt Channel and Base I/O Address
of the adapter.  They must match the adapter configuration.

For the HP/16 Plus an additional prompt is needed to configure the Memory
Map address.  Enter the letter 'y' to the prompt:

    Configure memory map base address (y/n) [n] or 'q' to quit:

Next, a prompt for the memory map address is displayed:

    Enter address selected in HPLANSET Memory Map Menu
    
Enter the addressed saved in the adapter by HPLANSET in step 2.



Note for EISA Computers
=======================

Run the EISA configuration utility supplied with the computer to select
values for the two HP/16 Plus resources:  I/O Address Range and Interrupt.
The EISA utility will ensure that resources allocated to the HP/16 Plus will
not be given to other adapters.

The EISA configuration files for the HP/16 Plus reside in the root directory
on the HP Support Disk.  Depending the EISA configuration utility supplied
with the computer there may be a prompt to insert a vendor diskette (the HP
Support Disk), or the configuration files may have to be copied to the
directory or floppy where the EISA configuration utility expects them.  

Below are directions for using the EISA utility to select resources for
the LAN Adapter/16 Plus:

A.  Run the EISA configuration utility supplied with the computer.
    Follow the procedure to add a new card to the computer.


B.  Select the proper configuration from the selections displayed:

    !HWP1832.CFG  HP EtherTwist PC LAN Adapter/16 TP Plus (27247B)
    !HWP18A0.CFG  HP EtherTwist PC LAN Adapter/16 TL Plus (27252A)

    Note: If the HP/16 Plus selections are not displayed and the EISA
          configuration utility did not prompt for the vendor diskette
          (the HP Support Disk), exit the EISA configuration utility.
          Copy the HP EISA configuration files to the directory or
          diskette containing the EISA configuration utility.  For example,
          if the HP Support Disk is in drive A, execute the following
          command:

             COPY A:*.CFG
    
          Then restart the EISA configuration process from step A.


C.  Use the EISA utility to view the adapter configuration details.

    If the "I/O Address Range" is not "300-31Fh (Factory Default)",
    see "Note on Resolving I/O Address Range Conflicts" below.


D.  Configure Memory Mapped Mode address.

    Highlight the "I/O or Memory Map" parameter and press the ENTER key.
    Select a memory-map address values from the choices presented and
    write down those values for use in HPLANSET in step 2.


E.  Save the configuration and turn off power to the computer when
    instructed by the EISA utility.

            +--------------------------------------------+
            | Continue with step one of the instructions |
            +--------------------------------------------+




Note on Resolving I/O Address Range Conflicts
=============================================
If any of the computer's adapters, including any other LAN adapters, are
using I/O addresses in the same I/O Address Range as the HP/16 Plus factory
default (300-31Fh), HPLANSET will not be able to find the HP/16 Plus.

There are two methods to complete the installation:
    1) Remove the adapter using I/O Address Range 300-31Fh.
       Install the HP/16 Plus and run HPLANSET.
       Use "Manual Configuration" to select another I/O Address Range.  
       Save the configuration to the HP/16 Plus.
       Reinstall the conflicting adapter.
or,
   2)  Install the HP/16 Plus in another computer and run HPLANSET.
       Use "Manual Configuration" to select another I/O Address Range.  
       Save the configuration to the HP/16 Plus.
       Remove the HP/16 Plus from the computer.
       Install the HP/16 Plus in the desired computer.



Note on Removing the Driver Package
===================================

When this update is removed, the previous version of the HPI driver will
be restored.  Any HP/16 Plus adapters will not be recognized by the
original HPI driver.


1.  Reboot the computer into the SCO operating system's System
    Maintenance (single user) mode.

2.  Run `custom'.  Then:
    A. Select `remove'.
    B. Select `HP ISA SCO LLI 3.1 Driver Update'.
    C. Select `All'.
    D. Exit custom.

3.  You must relink the kernel and re-boot your system for the removal
    to be completed.



Note on Driver Boot Error Messages
==================================

The following messages are produced during the HP ISA LLI driver
initialization during Unix boot.  Their purpose is to warn of any
configuration errors.  Except where noted, the adapter is ignored and
the driver will reject any open requests during networking
initialization with the message:

    hpi?: Card in invalid state to open (0)


NOTICE: Adapter not present

    This message is produced when the driver cannot identify the
    adapter at the configured I/O Address.  This message can be safely
    ignored if the HP LAN adapter is not installed.  This message can
    indicate the configuration for ISA adapters does not match the
    kernel configuration.  Running the HP diagnostic on the support
    disk is a good way to check the adapter configuration.  Follow the
    instructions in step 2 of either the "Update Installation" or "New
    Installation" instructions.


ERROR: Invalid I/O address(es)

    This message is produced when the configured I/O Address Range is
    not one of the supported I/O address ranges by the HP ISA LAN
    adapter.  The mkdev or netconfig utilities will not allow
    unsupported I/O ranges to be configured unless the wrong adapter
    type was chosen for this adapter during the add or modify
    operation.


ERROR: Invalid Interrupt Vector

    This message is produced when the configured Interrupt Vector is
    not one of the supported interrupt vectors by the HP LAN adapter.
    The mkdev or netconfig utilities will not allow an unsupported
    interrupt vector to configured unless the wrong adapter type was
    chosen for this adapter during the add or modify operation.


ERROR: Interrupt vector mismatch

    This message is produced only with HP LAN Adapter/16 Plus.  It
    indicates the interrupt vector given to the mkdev or netconfig
    utility does not match the vector saved in the adapter by the
    program HPLANSET on the HP Support Disk.


ERROR: Adapter not supported

    This message is produced if an older version of HP StarLAN 10
    adapter is installed.  It is not supported by the HP ISA LLI
    Driver.


hpi?: n streams outside legal range (7<n<256)

    This message is produced if the parameter HP_STREAMS in the file
    /etc/conf/pack.d/hpi0/space.c contains an illegal value `n'.  The
    default is sixteen open streams.  Edit the file
    /etc/conf/pack.d/hpi0/space.c and change the value of the
    HP_STREAMS parameter to within the permitted range.

    NOTE: Do not confuse streams opened to the driver with streams
    opened per network connection.  For example, IP opens one stream
    to the driver which all TCP connections are multiplexed (eg. n to
    1). The default value of 16 streams should handle all needs of
    SCO systems.


hpi?: n entries in multicast table exceeds x limit

    This message is produced if the multicast address table in the
    space.c file has been modified for too many multicast addresses.
    `n' is the value the driver received as the number of multicast
    addresses within the table in space.c file.  `x' is the maximum
    number permitted.  All adapters will still operate but will ignore
    all multicast addresses.  Edit file /etc/conf/pack.d/hpi0/space.c
    and change the value of the HP_MC_ADDRS parameter to below the
    limit.


The following messages are produced by the HP ISA LLI driver when
networking requests to open an HP Adapter/16 Plus.  This typically
occurs in the transition to multi-user state.


hpi?: Memory map not configured; using I/O transfers.

    A memory map address was configured by the mkdev or netconfig
    utilities but the memory map address was not saved in the adapter
    by the program HPLANSET on the HP Support Disk.  The adapter will
    continue to operate using I/O mode transfers.  Boot under MS-DOS
    and then run HPLANSET to configure the memory map address.


hpi?: Memory Map address does not match adapter; using I/O transfers.

    The memory map address configured by the mkdev or netconfig
    utilities does not match the memory map address saved in the
    adapter by the program HPLANSET on the HP Support Disk.  The
    adapter will continue to operate using I/O mode transfers.
    Run mkdev or netconfig and reconfigure the memory map address
    of the adapter so that it matches the value saved in the 
    adapter.


hpi?: Memory map range must be 2048 bytes; using I/O transfers.

    The memory map address range configured by the mkdev or netconfig
    utilities is not large enough.  The mkdev or netconfig utility
    always reserve a range 2048 bytes.  Insure file
    /etc/conf/sdevice.d/hpi? fields 9 and 10 are correct.  The adapter
    will continue to operate using I/O mode transfers.


hpi?: Cannot map memory into kernel; using I/O transfer.

    The memory map address does not start on a 4096 byte boundary or
    the operating system cannot map the requested memory range.  The
    adapter will continue to operate using I/O mode transfers.


hpi?: Memory map conflict; using I/O transfers.

    There is another device or an external memory cache interfering
    with memory mapped transfers.  Run the diagnostics provided by the
    program HPLANSET on the HP Support Disk.  If the adapter is
    installed in an EISA system, insure the adapter's memory map
    address range is configured in the system's EISA configuration
    utility.  The adapter will continue to operate using I/O mode
    transfers.


hpi?: Unable to perform LAN port auto-sense.

    There has been a error during LAN port auto-sense.  Run the
    diagnostics provided by the program HPLANSET on the HP Support
    Disk.  The networking's request to open the adapter will fail.


hpi?: Auto-sense LAN port failed. Verify cabling.

    Either no LAN media is attached or a network error occurred.
    Verify the LAN cabling is attached.  Run the diagnostics provided
    by the program HPLANSET on the HP Support Disk.  The networking's
    request to open the adapter will fail.


Other error messages can be produced by the driver due to extra
ordinary conditions within the system.  None are directly attributable
to user configuration errors.  Consult an authorized HP or SCO dealer
for more assistance when any messages not shown here appear.

