Sun Microsystems Quad User Manual

Sun™Quad FastEthernet

™

PCI Adapter Installation and User’s Guide

Sun Microsystems Computer Company

A Sun Microsystems, Inc. Business 2550 Garcia Avenue Mountain View, CA 94043 USA 415 960-1300 fax 415 969-9131

Part No.: 805-1797-10 Revision A, August 1997

Copyright 1997Sun Microsystems, Inc. 2550 Garcia Avenue,MountainView,California 94043-1100 U.S.A. All rights reserved. Thisproduct or document is protected by copyright anddistributed under licenses restricting its use, copying, distribution,and decompilation.

No part of this productor document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any.Third-partysoftware, including font technology,is copyrighted and licensed fromSun suppliers.

Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd.

Sun, Sun Microsystems,the Sun logo, AnswerBook, SunDocs, Quad FastEthernet, and Solaris aretrademarks, registered trademarks, or service marks of Sun Microsystems,Inc. in the U.S. and other countries. All SPARCtrademarks are used under license and are trademarks or registeredtrademarks of SPARCInternational,Inc. in the U.S. and othercountries. Productsbearing SPARCtrademarks are based upon an architecturedeveloped by Sun Microsystems, Inc.

The OPEN LOOK and Sun™ Graphical User Interface was developedby Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering effortsof Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry.Sun holds a non-exclusive license fromXerox to the Xerox Graphical User Interface, which license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements.

RESTRICTEDRIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions of FAR52.227-14(g)(2)(6/87) and FAR52.227-19(6/87),or DFAR 252.227-7015(b)(6/95) and DFAR227.7202-3(a).

DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

Copyright 1997 Sun Microsystems, Inc., 2550 Garcia Avenue,MountainView,Californie 94043-1100 Etatis-Unis. Tousdroitsréservés. Ce produit ou document est protégé par un copyrightet distribué avec des licences qui en restreignent l’utilisation, la copie, la distribution, et

la décompilation. Aucune partie de ce produitou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel détenu par des tiers, et qui comprendla technologie relativeaux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun.

Des parties de ce produitpourront être dérivées des systèmes BerkeleyBSD licenciés par l’Université de Californie. UNIX est une marque déposée auxEtats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company, Ltd.

Sun, Sun Microsystems,le logo Sun, AnswerBook, SunDocs, Quad FastEthernet et Solaris sont des marques de fabrique ou des marques déposées, ou marquesde service, de Sun Microsystems,Inc. aux Etats-Unis et dans d’autres pays. Touteslesmarques SPARCsont utilisées sous licence et sont des marquesde fabrique ou des marques déposéesde SPARCInternational, Inc.aux Etats-Uniset dans d’autres pays.Les produitsportant les marques SPARCsont basés sur une architecturedéveloppée parSun Microsystems,Inc.

L’interfaced’utilisationgraphique OPEN LOOK et Sun™ a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaîtles efforts de pionniers de Xerox pour la rechercheet le développement du concept des interfaces d’utilisation visuelle ou graphique pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xerox sur l’interface d’utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui en outre se conforment aux licences écrites de Sun.

CETTE PUBLICATION EST FOURNIE "EN L’ETAT"ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERNANT LA VALEURMARCHANDE,L’APTITUDEDE LA PUBLICATIONA REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.

Please

Recycle

Regulatory Compliance Statements

Your Sun product is marked to indicate its compliance class:

• Federal Communications Commission (FCC) — USA

• Department of Communications (DOC) — Canada

• Voluntary Control Council for Interference (VCCI) — Japan

Please read the appropriate section that corresponds to the marking on your Sun product before attempting to install the product.

FCC Class A Notice

This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:

1. This device may not cause harmful interference.

2. This device must accept any interference received, including interference that may cause undesired operation. Note: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC

Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his own expense.

Shielded Cables: Connections between the workstation and peripherals must be made using shielded cables in order to maintain compliance with FCC radio frequency emission limits. Networking connections can be made using unshielded twisted-pair (UTP) cables.

Modifications: Any modifications made to this device that are not approved by Sun Microsystems, Inc. may void the authority granted to the user by the FCC to operate this equipment.

FCC Class B Notice

This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:

1. This device may not cause harmful interference.

Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiateradio frequency energy and,if not installedand used in accordancewith the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:

• Reorient or relocate the receiving antenna.

• Increase the separation between the equipment and receiver.

• Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.

• Consult the dealer or an experienced radio/television technician for help.

Modifications: Any modifications made to this device that are not approved by Sun Microsystems, Inc. may void the authority granted to the user by the FCC to operate this equipment.

Regulatory Compliance Statements iii

DOC Class A Notice - AvisDOC, Classe A

This Class A digital apparatus meets all requirements of the Canadian Interference-Causing Equipment Regulations. Cet appareil numérique de la classe A respecte toutes les exigences du Règlement sur le matériel brouilleur du Canada.

DOC Class B Notice - AvisDOC, Classe B

This Class B digital apparatus meets all requirements of the Canadian Interference-Causing Equipment Regulations. Cet appareil numérique de la classe B respecte toutes les exigences du Règlement sur le matériel brouilleur du Canada.

iv Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997

Declaration of Conformity

Compliance ID: QFEPCI Product Name: SUN QFE PCI

This product has been tested and complies with the following EMC and Safety standards:

EMC

— Europe

This equipment complies with the following requirements of the EMC Directive 89/336/EEC:

EN55022 / CISPR22 (1985) Class A EN50082-1 IEC801-2 (1991) 4 kV (direct), 8 kV (air)

IEC801-3 (1984) 3 V/m IEC801-4 (1988) 1.0 kV power lines, 0.5 kV signal lines

EN61000-3-2/IEC1000-3-2 (1994) Pass

Safety

This equipment complies with the following requirements of the Low Voltage Directive 73/23/EEC:

• EN60950/IEC950 (1993)

Supplementary Information

This product was tested and complies with all the requirements for the CE Mark when connected to a Sun workstation or server.

/ S / / S / Dennis P. Symanski Date John Shades Date Manager, Product Compliance Manager, Quality Assurance

Sun Microsystems Computer Company Sun Microsystems Limited 2550 Garcia Avenue, M/S UMPK15-102 Springfield, Linlithgow Mt. View, CA 94043, USA West Lothian, EH49 7LR Tel: 415-786-3255 Scotland, United Kingdom Fax: 415-786-3723 Tel: 0506 670000

Fax: 0506 760011

Declaration of Conformity v

vi Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997

1. Product Overview 1

Features 2 Hardware and Software Requirements 3 Checking the OpenBoot PROM Revision Level 3

▼ Displaying the OpenBoot PROM Revision Level 3

2. Installing the Adapter 5

Adding an Entry to the driver_aliases File 5 Installing the Adapter 6 Verifying the Installation 7 Examining Network Activity 8 Rebooting the System 9

3. Configuring the Driver Software 11

Installing the Driver Software 11 Configuring the Host Files 11 Booting From the Network 14 Post-Installation Procedures (Optional) 15

Configuring Driver Parameters 15 Increasing TCP/IP Performance 15

Contents vii

Forcing Network Speed Between 10 Mbps and 100 Mbps 16 Auto-Negotiation 17 local-mac-address Property 18

A. Specifications 19

Physical Dimensions 19 Power Requirements 20 Performance Specifications 20

B. Interface Signals 21

C. Configuring the Quad FastEthernet Device Driver Parameters 23

Internal Transceiver 23 Driver Parameter Values and Definitions 24

Defining the Current Status 25 Inter-Packet Gap Parameters 25 Defining an Additional Delay Before Transmitting a Packet Using

lance_mode and ipg0 26 Operational Mode Parameters 27 Defining the Number of Back-to-Back Packets to Transmit 28 Reporting Transceiver Capabilities 28 Reporting the Link Partner Capabilities 29

Setting qfe Driver Parameters 30

Setting Parameters Using the ndd Utility 30

▼ To Specify the Device Instance for the ndd Utility 31 ▼ To Select One Local Transceiver Capability and Setting Forced

Mode 34

▼ To Set the Mode to Auto-Negotiation 34

Setting Parameters in the /etc/system File 35

▼ Setting the ipg1 and ipg2 Parameters in the /etc/system File 36

viii Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997

Setting Parameters Using the qfe.conf File 36

Setting ipg Driver Parameters Using a qfe.conf File 37

D. Running Diagnostics Tests 39

Using the OpenBoot PROM FCode Selftest 39

▼ Running the Ethernet FCode Selftest Diagnostic 40

Contents ix

x Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997

Preface

The Sun Quad FastEthernet PCI Adapter Installation and User’s Guide provides installation instructions for the Sun™ Quad FastEthernet™ PCI Adapter. This manual also describes how to configure the Sun Quad FastEthernet driver software.

These instructions are designed for system administrators with experience installing similar hardware.

How This Book Is Organized

Chapter 1, “Product Overview,” describes the hardware and software features for the Sun Quad FastEthernet PCI adapter.

Chapter 2, “Installing the Adapter,” tells you how to install the Sun Quad FastEthernet PCI adapter into your system.

Chapter 3, “Configuring the Driver Software,” describes how to create and edit the device driver configuration files.

Appendix A, “Specifications,” lists the specifications for the Sun Quad FastEthernet PCI adapter.

Appendix B, “Interface Signals,” lists the pin descriptions. Appendix C, “Configuring the Quad FastEthernet Device Driver Parameters,”

describes how to configure the Quad FastEthernet (qfe) driver. Appendix D, “Running Diagnostics Tests,” describes the diagnostic procedures for

testing the Sun Quad FastEthernet PCI adapter.

Preface xi

UNIX Commands

This document may not include specific software commands or procedures. Instead, it may name software tasks and refer you to operating system documentation or the handbook that was shipped with your new hardware.

The type of information that you might need to use references for includes:

■ Shutting down the system

■ Booting the system

■ Configuring devices

■ Other basic software procedures

See one or more of the following:

■ Solaris 2.x Handbook for SMCC Peripherals contains Solaris™ 2.x software

commands.

■ On-line AnswerBook™ for the complete set of documentation supporting

the Solaris 2.x software environment.

■ Other software documentation that you received with your system.

xii Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997

Typographic Conventions

The following table describes the typographic changes used in this book.

Typeface or Symbol Meaning Example

AaBbCc123 The names of commands, files,

and directories; on-screen computer output

AaBbCc123

AaBbCc123 Command-line placeholder:

AaBbCc123 Book titles, new words or terms,

What you type, contrasted with on-screen computer output

replace with a real name or value

or words to be emphasized

Edit your.login file. Use ls -a to list all files.

You have mail.

machine_name% su Password:

To delete a file, type rm filename.

Read Chapter 6 in the User’s Guide. These are called class options. You must be root to do this.

Shell Prompts

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Shell Prompt

C shell machine_name% C shell superuser machine_name# Bourne shell and Korn shell $ Bourne shell and Korn shell

superuser

Preface xiii

Ordering Sun Documents

SunDocsSMis a distribution program for Sun Microsystems technical documentation. Contact SunExpress for easy ordering and quick delivery. You can find a listing of available Sun documentation on the World Wide Web.

TABLEP-1 SunExpress Contact Information

Country Telephone Fax

Belgium 02-720-09-09 02-725-88-50 Canada 1-800-873-7869 1-800-944-0661 France 0800-90-61-57 0800-90-61-58 Germany 01-30-81-61-91 01-30-81-61-92 Holland 06-022-34-45 06-022-34-46 Japan 0120-33-9096 0120-33-9097 Luxembourg 32-2-720-09-09 32-2-725-88-50 Sweden 020-79-57-26 020-79-57-27 Switzerland 0800-55-19-26 0800-55-19-27 United Kingdom 0800-89-88-88 0800-89-88-87 United States 1-800-873-7869 1-800-944-0661

World Wide Web: http://www.sun.com/sunexpress/

Sun Welcomes Your Comments

Please use the Reader Comment Card that accompanies this document. We are interested in improving our documentation and welcome your comments and suggestions.

If a card is not available, you can email or fax your comments to us. Please include the part number of your document in the subject line of your email or fax message.

■ Email: smcc-docs@sun.com

■ Fax: SMCC Document Feedback

1-415-786-6443

xiv Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997

CHAPTER

Product Overview

The Sun Quad FastEthernet PCI adapter contains four fully-buffered twisted-pair Ethernet ports (RJ-45), providing four switchable 10BASE-T/100BASE-TX channels, on a PCI adapter.

Ethernet Connectors

FIGURE 1-1 Sun Quad FastEthernet PCI adapter

PCI Connector

Ethernet channels

0123

LEDs

FIGURE 1-2 Sun Quad FastEthernet PCI adapter Back Panel

Features

This PCI adapter offers the following features:

■ Fully complies with the ANSI/IEEE std. 802.3 CSMA/CD physical layer

specification

■ Four Switchable 10BASE-T/100BASE-TX Ethernet channels with auto

negotiation. Conforms to IEEE 802.3u Ethernet standard

■ Provides operations of up to 100 meters of twisted-pair without use of

repeaters

■ Four independent Ethernet channels run at either 10 Mbps or 100 Mbps

■ Supports half-duplex or full-duplex operation modes

■ Multiple 48-bit IEEE 802.3 style media access control (MAC) identifiers, one for

each channel

■ Link integrity LED for each channel

2 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997

Hardware and Software Requirements

Before installing the adapter, make sure your system meets the following hardware and software requirements:

TABLE1-1 Hardware and Software Requirements

Requirements Hardware or Software

Supported Systems Sun™ Ultra™ systems, with an available PCI slot. Supported Operating

Environments OpenBoot™ PROM (OBP) Release 3.0 or later

Note – The information above is up-to-date as of the printing of this manual. Visit

Sun on the World Wide Web at http://www.sun.com/ for the latest information.

Solaris 2.5.1 Hardware: 4/97, and later Solaris releases

Checking the OpenBoot PROM Revision Level

You can use the OpenBoot command .version to display your system’s OpenBoot PROM revision level.

▼ Displaying the OpenBoot PROM Revision Level

● At the ok prompt, type .version to check your system’s OpenBoot PROM

revision level.

ok .version Release 3.00 Version 1203 created 97/04/19 09:44:48

Chapter 1 Product Overview 3

4 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997

CHAPTER

Installing the Adapter

This chapter tells you how to install the Sun Quad FastEthernet PCI adapter in your system and how to verify that it has been installed correctly.

Adding an Entry to the driver_aliases File

If your system is running the Solaris 2.5.1 Hardware: 4/97 operating environment, you will need to add an entry to the /etc/driver_aliases file before installing the Sun Quad FastEthernet PCI adapter. In future operating system releases, you will not need to edit this file.

1. Check the /etc/driver_aliases file for the line required by the adapter.

# grep 'pci_pci "pci1011,25"' /etc/driver_aliases

If this line already exists in the driver_aliases file, you can proceed with the adapter installation, which is described in the next section. Otherwise, you will need to add this line to the file before installing the adapter.

2. Using a text editor, add the following line to the end of the

/etc/driver_aliases file.

pci_pci "pci1011,25"

Once you have added this line to the file, you can safely install the adapter.

+ 43 hidden pages