DEC 10/100Base-T
SCO Unix (MDI)

DC21X4 driver for SCO Unix

V03.32

1. Copyright Notice:

Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

Copyright Digital Equipment Corporation 1994, 1995, 1996.

All rights reserved.

Do not redistribute the driver files.

Copyright SCO Unix, Inc. 1994.

SCO Unix is a registered trademark of SCO Inc.

Digital Semiconductor, DEC, DECnet, Digital, PATHWORKS, ThinWire, and the DIGITAL logo, are trademarks of Digital Equipment Corporation.

All other trademarks and registered trademarks are the property of their respective holders.

2. Overview:

This Readme file explains how to install the SCO Unix MDI driver. This driver is currently supported for the following devices:

Digital Semiconductor 21140/21140A Chipset

3. Preinstallation Hardware and Software Requirements:

A. Hardware Requirements:

An IBM-compatible personal computer with 80386 or higher microprocessor and PCI bus.

A Digital Semiconductor 21040 or Digital Semiconductor 21140 or Digital Semiconductor 21041 or Digital Semiconductor 21140A or Digital Semiconductor 21142 or Digital Semiconductor 21143 based Ethernet / Fast Ethernet adapter for that bus.

B. Firmware Requirements:

Fully complient Rev. 2.0 or above PCI BIOS supplied with the PC.

If Ethernet adapter makes use of Digital Semiconductor 21050 (PCI-PCI bridge) or any other PCI-PCI bridge, the PCI BIOS should support PCI-PCI bridge architecture.

C. Software Revision Requirements:

4. Files and Directories:

This directories contains the following files:

Table 1: The SCO Unix MDI driver Directory Files

TSUM_INS.TXT This File

TSUM_REL.TXT Provides a description of updates to the new driver.

SUM332TD.Z (28669) The compressed image of the distribution diskette.

The DC21X4 distribution diskette contains all the files required for installing the driver using custom and netconfig, in particular:

• custom related scripts.
• netconfig related scripts and AOF files.
• Driver.o, the driver
• Space.c, the parameter file
• space.h - header file, not intended to be modified
  

6. Installing Software:

To install the SCO Unix MDI Device Driver:

Copying the distribution files

• Copy the file SUM332TD.Z to SUM332T.dd.Z on a SCO Unix machine.

• Uncompress SUM332T.dd.Z to SUM332T.dd, using: uncompress SUM332T.dd
• Copy the file to a diskette. To create a 3.5" floppy in drive 0, use: dd if=SUM332T.dd of=/dev/rfd0135ds18 Mark the diskette:
  DC21X4 PCI Ethernet Adapter MDI driver
  Rel.03.32
• Run custom. From the menu select:

• Put the distribution diskette in the drive and select continue.
• When prompted for distribution floppy 1, just press enter.
• When custom has completed, remove the diskette and quit custom.
• Run netconfig. Add the desired chain. The DC21X4 drivers are called:

NOTE: For boards with more than one Digital Semiconductor 21X4X on

them, a driver must be installed for each active port on the board. Thus, if a board has two separate ports, two separate chains must be created in order to connect both ports to networks. This is similar to installing two boards, each with one port.

Not all ports must be active.

• You can change the default value of the media by using the "Advanced Options..." option in the menu.
• When the chain has been configured, select "Exit" from the netconfig menu.

• If you wish to change parameters in the space.c file, edit /etc/conf/pack.d/d21x/space.c and make the required changes. The changes will apply to all the installed boards.
• To activate the adapter, you must reboot. When the system boots, you should see the following message among the other configuration messages:

7. Parameters

The space.c file contains the different parameters that can be modified. They can be divided into several groups:

1. Port parameters. These include:

XXX_BUS_ARBITRATION

2. Driver tuning parameters:

XXX_RX_BUFS_TO_POST

3. Driver diagnostics control:

XXX_DEBUG

The meaning of each is explained in detail in the space.c file, including allowed values for each parameter. The values in space.c apply to ALL the installed boards, except the MAC address parameter.

Space.c is NOT the place to modify the board's slot number line. This must be modified in netconfig, by running the reconfiguration script.

The serial mode interface can be changed during netconfig as explained before.

8. Errors and trouble shooting

1. Mismatch between PCI configuration and netconfig/space.c:

In order for the adapter to work correctly, the same values that are used during the PCI configuration (e.g CFLT) must be used in the space.c file. Mismatches may cause the adapter to malfunction, or even hang the system.

Currently, the PCI setup takes precedence except for the value for the latency timer, which is taken from the space.c file.

9. Driver's error messages (when working in debug level > 0)

In "d21xi" the 'i' stands for a number between 0 and 3, indicating the particular instance of the driver the message is reported by.

• "d21xi Could not intialize driver, PCI BIOS couldn't read/write configuration register"

• "d21xi Could not intialize driver, found PCMC revision.1 with write-back cache mode"

• "d21xi Could not intialize driver, unsupported PCI board - DC21040 revision.1"

• "d21xi Could not intialize driver, unsupported board - DC21140 revision 1.0"

• "d21xi Could not intialize driver, unsupported Digital Semiconductor"
• This message will be printed if the board doesn't have one of the following Digital Semiconductor on it:
  • DC21040
  • DC21140
  • DC21140A
  • DC21041
  • DC21142
  • DC21143

• "d21xi Could not intialize driver, couldn't link interrupt handler to interrupt line"

• "d21xi Could not intialize driver, unsupported interrupt line was set by the PCI BIOS to CFIT"

• "d21xi Could not intialize driver, unsupported selected serial media"

• "d21xi [d21xinit] Could not initialize driver, autosense mode conflicts with GPR values in space.c"

• "d21xi Could not intialize driver, unsupported DC21041 mode"

• "d21xi Could not intialize driver, PCI board - couldn't read board's address"

• "d21xi Could not intialize driver, PCI board - wrong checksum of board's address"

• "d21xi Could not intialize driver, PCI board - the upper 16 bits of the CBIO != 0"

• "d21xi Could not intialize driver, SROM address is odd"

• "d21xi Could not intialize driver, try to read beyond the SROM last address"

• "d21xi Could not intialize driver, can't read/write from/to the SROM"

• "d21xi Could not intialize driver, SROM's checksum wrong"

• "d21xi Could not intialize driver, didn't find board's info in the SROM"

• "d21xi Could not intialize driver, read null address from the SROM"

• "d21xi Could not intialize driver, unsupported board"

• "d21xi Could not intialize driver, unsupported SROM version"

• "d21x ERROR, minor number n, Ethernet controller configuration problem"

• "d21xi [d21x_open] Ethernet controller not found"

• "d21xi [d21x_close] Problems stopping adapter"

• "d21xi Controller has transitioned to halted state d21xi Halt ID halt_reason"

• "d21xi - wput : unknown stream message db_type"

"d21xi Controller has transitioned to halted state! Halt ID: TX Jabber Timer Expired" or

This messages will be printed when a TX jabber timer expired when DC21X4 sends a packet. In this case the driver stop the adapter operation.

• "d21xi Controller has transitioned to halted state! Halt ID: Couldn't use PCI BIOS"

• "d21xi Controller has transitioned to halted state! Halt ID: Setupacket Timeout"

This messages will be printed when the driver fails to send setup packet

• "d21xi Controller has transitioned to halted state! Halt ID: System Error occured"

• "d21xi - Invalid MACIOC_SETMCA message"

• "d21xi - Invalid MACIOC_DELMCA message"

• "d21xi - Invalid MACIOC_GETMCA message"

• "d21xi - Invalid MACIOC_GETADDR message"

• "d21xi - Invalid MACIOC_PROMISC message"

• "d21xi - Invalid MACIOC_GETRADDR message"

• "d21xi - Invalid MACIOC_GETMCSIZE message"

• "d21xi - Internal Error : Mismatch in transmit list pointers"

• "d21xi - m_data with bad Ethernet header size"

• "d21xi - m_data - driver is not bound"

• "d21xi - uwput req : unknown; "

• "d21xi - uwput ioctl : default, uknown ioctl; "

• "d21xi - Internal error in autodetect!"

• "m_data : buffer reside in more than 2 pages - system error!"

• "d21x_alloc_rx_bufs : (buffer_size % 4) != 0)"

• "d21x_mac_hwfail_ind routine Can't allocate message block"
• This message will be printed when a HW problem was discovered and the driver can't allocate an error message

• "d21xi [d21xinit] could not initialize driver, unable to set phy's connection"
• This message will be printed when the driver fails to set MII PHY connection

"d21xi [d21xinit] could not initialize driver, unsupported admin control command"

This message will be printed when the driver try to set an unsupported admin command to the MII PHY.

• "d21xi [d21xinit] could not initialize driver, can't read MII PHY register
• This message will be printed when the driver try to read one of the MII PHY regiters without a success.
  
  
  
  
  
  
  
  

10. Hotline and Support Information:

Call Cubix Customer Service for information and technical support:

Voice 1-800-829-0551

Fax 1-702-888-1001

BBS 1-702-888-1003