                  Installing NDIS 2.0.1 drivers for the
                   HP 27247B PC LAN Adapter/16 TP Plus
                   HP 27252A PC LAN Adapter/16 TL Plus

In general, the NDIS 2.0.1 drivers can be used with any networking product
that supports such an interface.  Examples include FTP PC/TCP, SUN PC-NFS,
DEC PathWorks, Wollongong Pathway, and Hughes ProLINC.

This file explains how to prepare the NDIS 2.0.1 driver for third-party
products that do not supply an automated network setup program.  For
additional details, see the documentation from the product's vendor.
The process is typically:

    - Install and test the LAN Adapter/16 Plus.
    - Install the networking product.
    - Copy the NDIS 2.0.1 driver files from the HP Support Disk.
    - Modify the PROTOCOL.INI file.
    - Modify the CONFIG.SYS file.

Use the following instructions to install the LAN Adapter/16 Plus and
its NDIS 2.0.1 driver:

1.  Install the HP/16 Plus 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.

    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.  Install the networking product.

    Follow the installation documentation provided with the networking
    product to install the product on the computer.  If this is an OS/2
    system, reboot the system into OS/2 before proceeding.

    Ensure to select NDIS as the driver interface option.  Typically,
    the choices are NDIS, Packet Driver, or Open Data-Link Interface (ODI).

    Write down the name of the directory in which the networking product
    was installed, for use in step five.


4.  Copy the NDIS 2.0.1 driver from the HP Support Disk.

    Create a directory on the computer.  For example,

        C:
        MKDIR \NDIS

    Copy the NDIS 2.0.1 driver file from HP Support Disk this directory.
    For DOS computers with the HP Support Disk in floppy drive A:

        COPY A:\NDIS\HPLANP.DOS C:\NDIS

    For OS/2 computers with the HP Support Disk in floppy drive A:

        COPY A:\NDIS\HPLANP.OS2 C:\NDIS


5.  Edit the PROTOCOL.INI file with a text editor.

    Locate the PROTOCOL.INI file within the networking product's
    directory created in step three.

    The PROTOCOL.INI file must include a section describing the LAN adapter
    (the HPLANP section) and a section describing each of the network
    products being run.  Each network product section must include a
    a BINDINGS statement.

    The PROTOCOL.HP file included in the NDIS directory of the HP Support
    Disk includes all the information describing the HP/16 Plus adapter. Here
    is a copy of the file:

        ; HP PC LAN Adapter/16 Plus
        [HPLANP]
                drivername = HPLANP$
        ;       ioaddress = 0x300
        ;       interrupt = 3
        ;       maxhwtrans = 8
        ;       maxswtrans = 2
        ;       maxmulticast = 5
        ;       maxicnest = 1
        ; The 'aui' parameter is used to force the card to use the AUI
        ; port or the other port (twisted pair or thinlan depending on
        ; the adapter).
        ;       aui = no

    All the PROTOCOL.INI driver parameters except "drivername" have been
    commented out (using the ";" character) and are shown here only to
    illustrate the defaults. Only "DRIVERNAME" is mandatory. All the
    PROTOCOL.INI parameters, and their values, are listed in the
    "PROTOCOL.INI Parameter Definitions" note below.

    The PROTOCOL.HP file must be merged with the networking product's
    PROTOCOL.INI.  BINDINGS statements must be created to identify the
    LAN Adapter/16 Plus NDIS 2.0.1 driver to the networking product's
    protocol modules.

    An example PROTOCOL.INI file that supports FTP PC/TCP might look like
    the following:

         ; FTP's software
         [PKTDRV]
         drivername = PKTDRV$
         intvec = 0x65
         bindings = HPLANP                         <--- Add this line

         ; HP PC LAN Adapter/16 Plus               <--- Add this line
         [HPLANP]                                  <--- Add this line
         DRIVERNAME = HPLANP$                      <--- Add this line


6.  Modify Your CONFIG.SYS File.

    The CONFIG.SYS file must be modified to include DEVICE statements
    for the HPLANP driver, and each of the drivers for the applications
    you are using, and for the PROTMAN.DOS (or PROTMAN.OS2, as appropriate)
    file.  Here's an example portion of a DOS CONFIG.SYS file that supports
    the LAN Adapter/16 Plus and FTP PC/TCP version 2.1 and before:

        REM************************************************
        REM   FTP software, run startftp after bootup   ***
        REM************************************************
        DEVICE = C:\FTP\PROTMAN.DOS /I:C:\FTP
        DEVICE = c:\FTP\DIS_PKT.DOS
        DEVICE = c:\FTP\IPCUST.SYS
        DEVICE = c:\FTP\IFCUST.SYS
        REM************************************
        REM  HP LAN ADAPTER/16 PLUS DRIVER  ***
        REM************************************
        DEVICE = c:\NDIS\HPLANP.DOS

    Notes for users of FTP PC/TCP version 2.2 or later:
     
    The DIS_PKT.DOS, IPCUST.SYS, and IFCUST.SYS have been replaced
    with a single file DIS_PKT.GUP in FTP PC/TCP version 2.2.  The above
    example should be modified as below for FTP PC/TCP version 2.2:

        REM************************************************
        REM   FTP software, run startftp after bootup   ***
        REM************************************************
        DEVICE = C:\FTP\PROTMAN.DOS /I:C:\FTP
        DEVICE = c:\FTP\DIS_PKT.GUP
        REM************************************
        REM  HP LAN ADAPTER/16 PLUS DRIVER  ***
        REM************************************
        DEVICE = c:\NDIS\HPLANP.DOS
        
    Please refer to FTP PC/TCP's Installation Manual for details.

    Notes on the PROTMAN file:

    - PROTMAN must be loaded before the adapter driver and the
      application drivers; that is, the DEVICE statement for the
      PROTMAN file must be located before the other network
      DEVICE statement.

    - The "/I:" parameter in the DEVICE statement for the PROTMAN file
      identifies the path to the PROTOCOL.INI file.  In the example above,
      PROTOCOL.INI is located in the directory C:\FTP.


5. Reboot Your Computer and Execute NETBIND.EXE

     To activate your modified PROTOCOL.INI and CONFIG.SYS files, you must
     now reboot your system.  When the boot process is complete, run
     NETBIND.EXE.  This file is included with your networking product
     software.  NETBIND must be run each time your system is booted, so it
     is recommended that you include NETBIND.EXE in your AUTOEXEC.BAT file.



PROTOCOL.INI Parameter Definitions
==================================

Below is an explanation of each PROTOCOL.INI parameter in the [HPLANP_NIF]
section for the HP 27247B or HP 27252A PC LAN Adapter/16 Plus.

The only parameter that must be present is the "DRIVERNAME".

If more than one HP/16 Plus is installed, the "IOADDRESS" parameter is
also required.

All parameters have default values.  A parameter need not be present in
PROTOCOL.INI if its default value is satisfactory.


DRIVERNAME
     units:[n/a]
     range:[HPLANP$, HPLANP2$, HPLANP3$, HPLANP4$]
     default:[HPLANP$]

   Identifies the LAN adapter driver.  Use a unique value from the range 
   indicated for each HP LAN adapter installed in your computer.  If you
   had two adapters installed, you would use HPLANP$ for the first adapter,
   and HPLANP2$ for the second.


INTERRUPT
     units:[integer]
     range:[3,4,5,6,7,9,10,11,12,15]
     default:[read from adapter, factory default 3]

   If present, it indicates which interrupt channel the driver should
   configure the adapter to generate interrupts.  The driver will override
   the interrupt channel configured by HPLANSET in step 2 until the computer
   is rebooted.


IOADDRESS
     units:[n/a]
     range:[0x100, 0x120, 0x140, 0x160, 0x180, 0x1A0, 0x1C0, 0x1E0
            0x200, 0x220, 0x240, 0x260, 0x280, 0x2A0, 0x2C0, 0x2E0]
            0x300, 0x320, 0x340, 0x360, 0x380, 0x3A0, 0x3C0, 0x3E0]
     default:[search all addresses]

   If present, indicates the base I/O address (ie. the first address in 
   HPLANSET I/o Address Range) configured on the adapter.  If the adapter is
   not at the base I/O address, the driver will exit with an error.
   
   If more than one HP/16 Plus adapter is installed in the computer, this
   parameter must be present under each HP/16 Plus NIF section.


MAXHWTRANS
     units:[integer]
     range:[2-20]
     default:[8]

   If present, this controls how the adapter memory is partitioned into
   into a transmit queue and a receive ring buffer.  The parameter value
   specifies the number of full-sized transmit packets that can be
   simultaneously stored in the adapter's transmit queue.  Each transmit
   packet consumes 1536 bytes.  The remaining adapter memory is used as a
   receive ring buffer.

   Both of the HP/16 Plus adapters (HP 27247B and HP 27252A) have 32 Kbytes
   (32K X 8) of memory.

   For example, if a HP/16 Plus were configured with MAXHWTRANS = 10, 
   15360 bytes would be allocated to the transmit queue and 17408 
   (32768 - 15360) would be allocated for the receive ring buffer.


MAXMULTICAST
     units:[integer]
     range:[1-50]
     default:[5]

   If present, this controls the maximum number of multicast addresses
   that can be simultaneously stored by the driver.  Each address consumes
   16 bytes of computer memory.


MAXSWTRANS
     units:[integer]
     range:[1-10]
     default:2

   Occasionally the HPLANP driver will put a transmit packet in a software
   queue before sending it to the adapter's transmit queue.  This parameter,
   if present, controls the number of packets that can simultaneously be
   stored in the software queue.  Each queue entry consumes 146 bytes of
   computer memory.


MAXICNEST
     units:[integer]
     range:[1-4]
     default:1

   If present, this controls the interrupt nesting depth of the driver.
   The value is the number of outstanding NDIS Indication Complete calls
   that the driver will allow.  When the limit is reached the driver
   will cease processing receive indications until an outstanding
   Indication Complete has returned.  Higher values will use greater
   amounts of stack space.


AUI
     units:[n/a]
     range:[YES,NO]
     default:n/a

   If present, this controls which of the adapter's LAN connectors is used.
   A value of 'YES' forces the 15-pin DIX (AUI) connector to be used. 
   A value of 'NO' forces the native LAN connector on the adapter to be used.  
   On the HP 27247B, the native connector is an RJ-45 twisted-pair connector.  
   On the HP 27252B the native connector is a BNC connector for thin LAN.
   The driver will override the LAN Connector configured by HPLANSET in step
   2 until the computer is rebooted.

   When this parameter is not present, the driver will use the value 
   configured on the adapter by the HPLANSET utility.  HPLANSET can specify
   automatic selection (the default), or identify a specific connector to
   be used.  Run HPLANSET to view or modify the HP/16 Plus's configuration.




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 HP/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 Boot ROM Address, if needed.

    If a Boot ROM is to be installed on the adapter, select an address range
    from the choices presented under the "Boot ROM" parameter.  Write down
    the selction for use in step two.


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 original computer.

