home | help
CS(4)			  i386 Kernel Interfaces Manual 		   CS(4)

NAME
     cs -- ethernet device driver

SYNOPSIS
     device cs0 at isa? port 0x300 irq ?
     device cs1 at isa? port 0x300 irq 10 iomem 0xd0000

DESCRIPTION
     The  cs  driver  provides	support  for  ISA ethernet adapters based on the
     Crystal Semiconductor CS8900 and CS8920 NICs.  These devices  are	used  on
     the  IBM  EtherJet ISA adapters and in many embedded applications where the
     high integration, small size and low cost of the CS89x0  family  compensate
     for their drawbacks.

     The cs driver will obtain configuration parameters either from the configu-
     ration  entry  or from the card.  Parameters specified in the configuration
     entry will be used if present; the card may be soft-configured so these may
     be any valid value.  Adapters based on the CS8920 normally offer  PnP  con-
     figuration  and  the  driver  will  detect the IBM EtherJet and the CSC6040
     adapters automatically.

     Note that the CS8900 is limited to 4 IRQ values; these are normally  imple-
     mented as 5, 10, 11 and 12.  The CS8920 has no such limitation.

     Memory-mapped and DMA operation are not supported at this time.

DIAGNOSTICS
     cs%d: full/half duplex negotiation timeout  The attempt to negotiate duplex
     settings  with the hub timed out.	This may indicate a cabling problem or a
     faulty or incompatible hub.

     cs%d: failed to enable <media>  The CS89x0 failed to select  the  nominated
     media, either because it is not present or not operating correctly.

     cs%d:  No EEPROM, assuming defaults  The CS89x0 does not have an EEPROM, or
     the EEPROM is hopelessly damaged.	Operation will only be successful if the
     configuration entry lists suitable values for the adapter.

     cs%d: Invalid irq	The IRQ specified in  the  configuration  entry  is  not
     valid for the adapter.

     cs%d:  Could not allocate memory for NIC  There is a critical memory short-
     age.  The adapter will not function.

     cs%d: Adapter has no media  The adapter is not configured	for  a	specific
     media type.  The media type will have to be manually set.

     This is a %s, but LDN %d is disabled  The PnP probe code found a recognised
     adapter, but the adapter is disabled.

     failed  to read pnp parms	A PnP adapter was found, but configuration para-
     meters for it could not be read.

     failed to pnp card parametars  The parameters obtained via PnP were not ac-
     cepted by the driver.  The adapter may not function.

CAVEATS
     The CS89x0 family of adapters have a very small RAM buffer (4K).  This  may
     cause problems with extremely high network loads or bursty network traffic.
     In  particular,  NFS operations should be limited to 1k read/write transac-
     tions in order to avoid overruns.

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

AUTHORS
     The cs device driver was written by Maxim Bolotin and Oleg Sharoiko.   This
     manpage was written by Michael Smith.

FreeBSD 4.5			  July 20, 1998 			   CS(4)

home | help