                           Broadcom Corporation
                           16215 Alton Parkway,
                           Irvine, CA 92619-7013

                            Installation Notes
         Broadcom BCM5700 SCO Unixware 7/Caldera Open Unix 8 driver


Introduction
============

This file describes the SCO Unixware 7/Caldera Open Unix 8 driver for the
Broadcom NetXtreme BCM5700 series 10/100/1000 Mbps Ethernet Network Interface
Controller.


Driver Software Package
=======================

The driver is released as an installable package in datastream format. 


Installing Driver
=================

Do the following to install the bcme package on the Unixware system:

pkgadd -d <install_path>

where <install_path> is the full path name of the installable package
bcme-<version>.pkg. After the package is installed, use netcfg or
scoadmin network to add the new network adapter. When prompted, choose
the line speed and select Advanced option for Flow Control and MAC Address
settings if desired. The different settings of these parameters are
listed below:

    Line Speed:      Auto Negotiation (default) (all speeds advertised)

                     10 Mbps half duplex fixed
                     10 Mbps half duplex auto (only 10 Mbps half duplex
                                               advertised)
                     10 Mbps full duplex fixed
                     10 Mbps full duplex auto (only 10 Mbps full duplex
                                               advertised)
                     100 Mbps half duplex fixed
                     100 Mbps half duplex auto (only 100 Mbps half duplex
                                                advertised)
                     100 Mbps full duplex fixed
                     100 Mbps full duplex auto (only 100 Mbps full duplex
                                                advertised)
                     1000 Mbps full duplex fixed*
                     1000 Mbps full duplex auto (only 1000 Mbps full duplex
                                                 advertised)

    Flow Control:    Auto Negotiation** (Symmetric Pause advertised) (default)
                     Disabled			
                     Receive Pause
                     Transmit Pause
                     Receive & Transmit Pause

    MAC Address:     No Override (default)
                     a user administered MAC address entered with a colon
                     separating each hexadecimal byte, e.g.
                     12:34:56:78:9a:bc

    Jumbo MTU Size:  1500 - 9000 (default is 1500)

    Wirespeed:       Enabled ***
                     Disabled (default)


*Note that 1000 Mbps (1Gbps) full duplex fixed speed is only valid for fibre
connections. For copper twisted pair connections, 1 Gbps can only be set
through auto negotiation with a 1 Gbps link partner.

**Note that auto negotiation of flow control is only valid when the line
speed is set to auto negotiation (all speeds or single speed advertisments).

*** Ethernet@wirespeed allows the hardware to attempt to work with
broken ethernet cables.  It is not recommended that this option be used
when configuring interfaces in team.

After the parameters are selected, select network protocol and address
when prompted.

Advanced Tunable Parameters
===========================

Advanced tunable parameters for the BCM5700 are located in the file
/etc/conf/pack.d/bcme/space.c. Changing these parameters can affect the
performance of the driver. See the bcme man page for details.


Disabling ASF in the firmware
==============================

This driver does not support ASF.  If you find that the driver does
not load due to ASF being enabled in the firmware, use the following
procedure to disable it:

1.  Download the BCM57xx User diagnostic from our driver
    download site at :

    http://www.broadcom.com/drivers/downloaddrivers.php

2.  Create a DOS bootable floppy

3.  Unpack the diag zip-file into this floppy

4.  Boot to DOS using this floppy

5.  Enter "b57udiag -cmd"

6.  Enter setasf -d

7.  Reboot the system


Unexpected WARNING messages
===========================
This driver contains a new feature that allows the linkspeed, as reported
by ndstat, to be updated as the link conditions change.  Unfortunately,
this feature also produces a lot of warning messages on older UnixWare
installations.  If you see the following warning message, you will need
to update your installation :

WARNING : mdi_primitive_handler - Unexpected message from MDI driver(bcme),
	primitive = 0x17

To get rid of these messages, download and install Maintenance Pack 2 from
SCO's website.
