SIS(4)                    OpenBSD Programmer's Manual                   SIS(4)

NAME
     sis - SiS 900, SiS 7016, and NS DP83815 Fast Ethernet driver

SYNOPSIS
     sis* at pci? dev ? function ?

DESCRIPTION
     The sis driver provides support for PCI Ethernet adapters and embedded
     controllers based on the Silicon Integrated Systems SiS 900 and SiS 7016
     Fast Ethernet controller chips, as well as support for adapters based on
     the National Semiconductor DP83815 (MacPhyter) PCI Ethernet controller
     chip, including the Netgear FA311 and FA312.

     The SiS 900 is a 100Mbps Ethernet MAC and MII-compliant transceiver in a
     single package.  It uses a bus master DMA and a scatter/gather descriptor
     scheme.  The SiS 7016 is similar to the SiS 900 except that it has no in-
     ternal PHY, requiring instead an external transceiver to be attached to
     its MII interface.  The SiS 900 and SiS 7016 both have a 128-bit multi-
     cast hash filter and a single perfect filter entry for the station ad-
     dress.

     The NS DP83815 is also a 100Mbps Ethernet MAC with integrated PHY.  The
     NatSemi chip and the SiS 900 share many of the same features and a fairly
     similar programming interface, hence both chips are supported by the same
     driver.

     The sis driver supports the following media types:

     autoselect            Enable autoselection of the media type and options.
                           The user can manually override the autoselected
                           mode by adding media options to the hostname.if(5)
                           file.

     10baseT/UTP           Set 10Mbps operation.  The mediaopt option can also
                           be used to select either full-duplex or half-duplex
                           modes.

     100baseTX             Set 100Mbps (Fast Ethernet) operation.  The
                           mediaopt option can also be used to select either
                           full-duplex or half-duplex modes.

     The sis driver supports the following media options:

     full-duplex           Force full duplex operation

     half-duplex           Force half duplex operation.

     For more information on configuring this device, see ifconfig(8).

DIAGNOSTICS
     sis%d: couldn't map ports/memory  A fatal initialization error has oc-
     curred.

     sis%d: couldn't map interrupt  A fatal initialization error has occurred.

     sis%d: watchdog timeout  The device has stopped responding to the net-
     work, or there is a problem with the network connection (cable).

     sis%d: no memory for rx list  The driver failed to allocate an mbuf for
     the receiver ring.

     sis%d: no memory for tx list  The driver failed to allocate an mbuf for
     the transmitter ring when allocating a pad buffer or collapsing an mbuf

     chain into a clusisr.

     sis%d: chip is in D3 power state -- setting to D0  This message applies
     only to adapters which support power management.  Some operating systems
     place the controller in low power mode when shutting down, and some PCI
     BIOSes fail to bring the chip out of this state before configuring it.
     The controller loses all of its PCI configuration in the D3 state, so if
     the BIOS does not set it back to full power mode in time, it won't be
     able to configure it correctly.  The driver tries to detect this condi-
     tion and bring the adapter back to the D0 (full power) state, but this
     may not be enough to return the driver to a fully operational condition.
     If you see this message at boot time and the driver fails to attach the
     device as a network interface, you will have to perform second warm boot
     to have the device properly configured.

     Note that this condition only occurs when warm booting from another oper-
     ating system.  If you power down your system prior to booting OpenBSD,
     the card should be configured correctly.

SEE ALSO
     arp(4), netintro(4), ifconfig(8)

     SiS 900 and SiS 7016 datasheets, http://www.sis.com.tw.

     NatSemi DP83815 datasheet, http://www.national.com.

HISTORY
     The sis device driver first appeared in FreeBSD 3.0. OpenBSD support was
     added in OpenBSD 2.7.

AUTHORS
     The sis driver was written by Bill Paul <wpaul@ee.columbia.edu> and port-
     ed to OpenBSD by Aaron Campbell <aaron@openbsd.org>.

OpenBSD 2.9                    September 4, 1999                             2
