Sun Microsystems Network Card Sun Quad User Manual

Sun Quad FastEthernet  
PCI Adapter Installation and  
Users 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 1997 Sun Microsystems, Inc. 2550 Garcia Avenue, Mountain View, California 94043-1100 U.S.A. All rights reserved.  
This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation.  
No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors,  
if any. Third-party software, including font technology, is copyrighted and licensed from Sun 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 are trademarks, registered trademarks, or  
service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or  
registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an  
architecture developed by Sun Microsystems, Inc.  
The OPEN LOOK and Sun™ Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges  
the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun  
holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Suns licensees who implement  
OPEN LOOK GUIs and otherwise comply with Suns written license agreements.  
RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions of FAR 52.227-14(g)(2)(6/ 87) and  
FAR 52.227-19(6/ 87), or DFAR 252.227-7015(b)(6/ 95) and DFAR 227.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 NON-  
INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.  
Copyright 1997 Sun Microsystems, Inc., 2550 Garcia Avenue, Mountain View, Californie 94043-1100 Etatis-Unis. Tous droits réservés.  
Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent lutilisation, la copie, la distribution, et  
la décompilation. Aucune partie de ce produit ou 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, sil y en a. Le logiciel détenu par des tiers, et qui comprend la technologie  
relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun.  
Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque  
déposée aux Etats-Unis et dans dautres 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 marques de service, de Sun Microsystems, Inc. aux Etats-Unis et dans dautres pays. Toutes les marques SPARC sont utilisées sous  
licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans dautres pays. Les  
produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc.  
L’interface dutilisation graphique OPEN LOOK et Sun™ a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun  
reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces dutilisation visuelle ou graphique  
pour lindustrie de linformatique. 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 linterface dutilisation 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, NEST ACCORDEE, Y COMPRIS  
DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, LAPTITUDE DE LA PUBLICATION A 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  
 
DOC Class A Notice - Avis DOC, 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 - Avis DOC, 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  
EC Europe  
This equipment complies with the following requirements of the EMC Directive 89/ 336/ EEC:  
EN55022 / CISPR22 (1985)  
EN50082-1 IEC801-2 (1991)  
Class A  
4 kV (direct), 8 kV (air)  
3 V/ m  
IEC801-3 (1984)  
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  
Manager, Product Compliance  
Date  
John Shades  
Manager, Quality Assurance  
Date  
Sun Microsystems Computer Company  
2550 Garcia Avenue, M/ S UMPK15-102  
Mt. View, CA 94043, USA  
Tel: 415-786-3255  
Sun Microsystems Limited  
Springfield, Linlithgow  
West Lothian, EH49 7LR  
Scotland, United Kingdom  
Tel: 0506 670000  
Fax: 415-786-3723  
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
3
3
5
3
2. Installing the Adapter  
Adding an Entry to the driver_aliasesFile  
Installing the Adapter  
5
6
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  
 
A. Specifications 19  
C. Configuring the Quad FastEthernet Device Driver Parameters 23  
Internal Transceiver 23  
Driver Parameter Values and Definitions 24  
lance_modeand 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  
To Select One Local Transceiver Capability and Setting Forced  
Mode 34  
To Set the Mode to Auto-Negotiation 34  
Setting Parameters in the /etc/systemFile 35  
Setting the ipg1and ipg2Parameters in the /etc/systemFile 36  
viii  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
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 Users 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.  
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  
Appendix A, “Specifications,” lists the specifications for the Sun Quad FastEthernet  
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  
 
Related Documents  
The following documents contain topics that relate to the information  
in the Sun Quad FastEthernet PCI Adapter Installation and Users Guide.  
Title  
Part Number  
Your system installation or service manual  
Solaris 2.x Handbook for SMCC Peripherals  
SunVTS Users Guide  
(System dependent)  
(Release dependent)  
(Release dependent)  
804-5901  
Sun Quad FastEthernet 2.0 CD-Insert  
OpenBoot 3.x Command Reference Manual  
802-5837  
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  
Edit your.loginfile.  
Use ls -ato list all files.  
You have mail.  
What you type, contrasted with  
on-screen computer output  
AaBbCc123  
machine_name% su  
Password:  
AaBbCc123  
Command-line placeholder:  
replace with a real name or  
value  
To delete a file, type rmfilename.  
AaBbCc123  
Book titles, new words or terms, Read Chapter 6 in the Users Guide.  
or words to be emphasized  
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  
Bourne shell and Korn shell  
machine_name#  
$
#
Bourne shell and Korn shell  
superuser  
Preface  
xiii  
 
Ordering Sun Documents  
SunDocsSM is 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.  
TABLE P-1 SunExpress Contact Information  
Country  
Telephone  
Fax  
Belgium  
02-720-09-09  
1-800-873-7869  
0800-90-61-57  
01-30-81-61-91  
06-022-34-45  
0120-33-9096  
32-2-720-09-09  
020-79-57-26  
0800-55-19-26  
0800-89-88-88  
1-800-873-7869  
02-725-88-50  
1-800-944-0661  
0800-90-61-58  
01-30-81-61-92  
06-022-34-46  
0120-33-9097  
32-2-725-88-50  
020-79-57-27  
0800-55-19-27  
0800-89-88-87  
1-800-944-0661  
Canada  
France  
Germany  
Holland  
Japan  
Luxembourg  
Sweden  
Switzerland  
United Kingdom  
United States  
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.  
Fax: SMCC Document Feedback  
1-415-786-6443  
xiv Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
     
CHAPTER  
1
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.  
PCI  
Connector  
Ethernet  
Connectors  
FIGURE 1-1 Sun Quad FastEthernet PCI adapter  
1
 
       
Ethernet channels  
0
1
2
3
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:  
TABLE 1-1  
Hardware and Software Requirements  
Requirements  
Hardware or Software  
Supported Systems  
Sun™ Ultra™ systems, with an available PCI slot.  
Solaris 2.5.1 Hardware: 4/ 97, and later Solaris releases  
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.  
Checking the OpenBoot PROM Revision  
Level  
You can use the OpenBoot command .versionto display your systems OpenBoot  
PROM revision level.  
Displaying the OpenBoot PROM Revision Level  
At the okprompt, type .versionto check your systems 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  
2
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_aliasesFile  
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_aliasesfile 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_aliasesfile for the line required by the adapter.  
# grep 'pci_pci "pci1011,25"' /etc/driver_aliases  
If this line already exists in the driver_aliasesfile, 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_aliasesfile.  
pci_pci "pci1011,25"  
Once you have added this line to the file, you can safely install the adapter.  
5
 
             
Installing the Adapter  
Note – Refer to your system installation or service manual for detailed instructions  
for the following tasks.  
1. Power off your system and open the system unit.  
2. Attach the adhesive copper strip of the wrist strap to the metal casing of the  
power supply. Wrap the other end twice around your wrist, with the adhesive side  
against your skin.  
3. Holding the PCI adapter by the edges, unpack and place it on an antistatic  
surface.  
4. Remove the PCI filler panel from the slot in which you want to insert the Sun  
Quad FastEthernet PCI adapter.  
5. Holding the PCI adapter by the edges, align the adapter edge connector with the  
PCI slot. Slide the adapter face plate into the small slot at the end of the PCI  
opening.  
6. Applying even pressure at both corners of the adapter, push the PCI adapter until  
it is firmly seated in the slot.  
Caution – Do not use excessive force when installing the adapter into the PCI slot.  
You may damage the adapters PCI connector. If the adapter does not seat properly  
when you apply even pressure, remove the adapter and carefully reinstall it again.  
7. If necessary, reinstall the PCI filler panel in the unused PCI opening.  
8. Detach the wrist strap and close the system unit.  
9. Connect Ethernet cables to the Sun Quad FastEthernet PCI adapter and to an  
Ethernet network.  
6
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
     
Verifying the Installation  
After you have installed the Sun Quad FastEthernet PCI adapter, but before you boot  
your system, perform the following tasks to verify the installation. Refer to the  
Solaris 2.x Handbook for SMCC Peripherals manual or your Solaris documentation for  
the detailed instructions.  
1. Power on the system, and when the banner appears, press the Stop-A keys to  
interrupt the boot process and to get to the okprompt.  
2. Use the show-devscommand to list the system devices.  
You should see lines in the list of devices, similar to the example below, specific to  
the Sun Quad FastEthernet PCI adapter:  
ok show-devs  
...  
/pci@1f,2000/pci@2/SUNW,qfe@0,1  
/pci@1f,2000/pci@2/SUNW,qfe@1,1  
/pci@1f,2000/pci@2/SUNW,qfe@2,1  
/pci@1f,2000/pci@2/SUNW,qfe@3,1  
...  
The SUNW,qfe@x,1entries identify the adapters four Ethernet devices.  
Note – If you do not see the devices listed, check that the adapter is properly seated  
and, if necessary, reinstall the adapter.  
Diagnostic Testing  
For Sun Quad FastEthernet PCI adapter diagnostic testing, see Appendix D,  
“Running Diagnostics Tests.”.  
Chapter 2  
Installing the Adapter  
7
 
       
Examining Network Activity  
After you have installed the Sun Quad FastEthernet PCI adapter, but before booting  
the system, verify the installation by examining the network interfaces with the  
OpenBoot PROM watch-net-allcommand.  
Make sure that the interfaces are connected to an active network.  
Examine network activity and incoming network packets by typing  
watch-net-allat the okprompt.  
The watch-net-allcommand monitors network traffic on all network interfaces  
in the system. In the example below, the watch-net-allcommand tests all four of  
the adapters interfaces, two of which are connected to a network.  
ok watch-net-all  
/pci@1f,2000/pci@2/SUNW,qfe@0,1  
Internal loopback test -- succeeded.  
Transceiver check -- failed  
/pci@1f,2000/pci@2/SUNW,qfe@1,1  
Internal loopback test -- succeeded.  
Transceiver check -- passed  
Looking for Ethernet Packets.  
'.' is a Good Packet. 'X' is a Bad Packet.  
Type any key to stop.  
..................................... (Press any key to continue.)  
/pci@1f,2000/pci@2/SUNW,qfe@2,1  
Internal loopback test -- succeeded.  
Transceiver check -- failed  
/pci@1f,2000/pci@2/SUNW,qfe@3,1  
Internal loopback test -- succeeded.  
Transceiver check -- passed  
Looking for Ethernet Packets.  
'.' is a Good Packet. 'X' is a Bad Packet.  
Type any key to stop.  
In addition to testing the adapters interfaces, the watch-net-allcommand may  
also test other network devices on the system.  
Note – The network speed is the same as the speed of the network that your system  
is connected. See the section “Forcing Network Speed Between 10 Mbps and 100  
Mbps” on page 16 for more detailed information about speed selection.  
8
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
       
Rebooting the System  
After you have examined the network activity, perform a reconfiguration boot on  
your system so the operating environment can recognize the Sun Quad FastEthernet  
PCI adapter.  
Perform a reconfiguration boot on the system.  
ok boot -r  
Refer to the Solaris 2.x Peripherals Handbook for more information.  
Chapter 2  
Installing the Adapter  
9
 
     
10  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
CHAPTER  
3
Configuring the Driver Software  
This chapter describes how to configure the driver software used by the Sun Quad  
FastEthernet PCI adapter.  
Installing the Driver Software  
The Sun Quad FastEthernet 2.0 CD-ROM contains the software required by the Sun  
Quad FastEthernet PCI adapter. Install the software driver packages as described in  
the CD insert. (Future revisions of the Sun Quad FastEthernet software will also  
work with your adapter.)  
Before you can use the four channels of the adapter, you will need to create and edit  
system host files, as described in the next section.  
Configuring the Host Files  
After installing the Sun Quad FastEthernet driver software, you must create a  
hostname.qfe<num> file for the adapters Ethernet interfaces. You must also create  
both an IP address and a host name for its Ethernet interfaces in the /etc/hosts  
file.  
11  
 
                       
1. At the command line, use the grepcommand to search the /etc/path_to_inst  
file for qfedevices.  
# grep qfe /etc/path_to_inst  
"/pci@1f,2000/pci@2/SUNW,qfe@0,1" 4 "qfe"  
"/pci@1f,2000/pci@2/SUNW,qfe@1,1" 5 "qfe"  
"/pci@1f,2000/pci@2/SUNW,qfe@2,1" 6 "qfe"  
"/pci@1f,2000/pci@2/SUNW,qfe@3,1" 7 "qfe"  
In the example above, the four SUNW,qfe@x,1instances are from a Sun Quad  
FastEthernet PCI adapter installed in slot 2. For clarity, the instance numbers are  
bold.  
2. Create an /etc/hostname.qfe<num> file, where <num> corresponds to the  
instance number of each interface you plan to use.  
If you wanted to use all of the adapters interfaces in Step 1’s example, you would  
need to create four files:  
Filename  
Instance  
Number  
Adapter Ethernet Channel  
(See FIGURE 1-2 on page 2)  
/etc/hostname.qfe4  
/etc/hostname.qfe5  
/etc/hostname.qfe6  
/etc/hostname.qfe7  
4
5
6
7
0
1
2
3
Do not create /etc/hostname.qfe<num> files for Sun Quad FastEthernet PCI  
adapter channels you plan to leave unused.  
The /etc/hostname.qfe<num> file must contain the hostname for the  
appropriate network interface.  
The host name should have an IP address and should be entered in the  
/etc/hostsfile.  
The host name should be different from any other host name of any other  
interface, for example: /etc/hostname.hme0and /etc/hostname.qfe2  
cannot share the same host name.  
12  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
         
Using the instance examples in Step 1, the following example shows the four  
/etc/hostname.qfe<num> files required for a system called zardozthat has a  
Sun Quad FastEthernet PCI adapter (zardoz-11, zardoz-12, zardoz-13, and  
zardoz-14).  
# cat /etc/hostname.hme0  
zardoz  
# cat /etc/hostname.qfe4  
zardoz-11  
# cat /etc/hostname.qfe5  
zardoz-12  
# cat /etc/hostname.qfe6  
zardoz-13  
# cat /etc/hostname.qfe7  
zardoz-14  
3. Create an appropriate entry in the /etc/hostsfile for each active qfechannel.  
Using the example in Step 1, you will have:  
# cat /etc/hosts  
#
# Internet host table  
#
127.0.0.1  
localhost  
129.144.10.57 zardoz  
loghost  
129.144.11.83 zardoz-11  
129.144.12.41 zardoz-12  
129.144.13.67 zardoz-13  
129.144.14.30 zardoz-14  
4. Reboot your system.  
Chapter 3  
Configuring the Driver Software  
13  
 
   
Booting From the Network  
To use a Sun Quad FastEthernet PCI adapter ethernet interface as the boot device,  
perform the following tasks:  
1. At the okprompt type:  
ok show-devs  
The show-devscommand lists the system devices. You should see the full path  
name of the qfedevices, similar to the example below:  
/pci@1f,2000/pci@2/SUNW,qfe@0,1  
/pci@1f,2000/pci@2/SUNW,qfe@1,1  
/pci@1f,2000/pci@2/SUNW,qfe@2,1  
/pci@1f,2000/pci@2/SUNW,qfe@3,1  
Note – You need to select only one of these qfedevices for booting.  
2. At the okprompt type:  
ok boot (full path name of the qfedevice)  
14  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
     
Post-Installation Procedures (Optional)  
Perform the tasks in the following sections to customize the performance of the Sun  
Quad FastEthernet PCI adapter.  
Configuring Driver Parameters  
The qfedevice driver, which is loaded from the CD-ROM, controls the SUNW,qfe  
Ethernet devices. The device driver automatically selects the link speed using the  
auto-negotiation protocol with the link partner. (See “Auto-Negotiation” on  
page 17.)  
You can manually configure the qfedevice driver parameters to customize each  
SUNW,qfedevice in your system in one of three ways:  
Configure the qfedriver parameters generally for all SUNW,qfedevices in the  
Set a parameter on a per-device basis by creating the qfe.conffile in the  
/kernel/drvdirectory.  
Use the nddutility to temporarily change a parameter. This change is lost when  
you reboot the system.  
See Appendix C, “Configuring the Quad FastEthernet Device Driver Parameters,”  
for more information.  
Increasing TCP/ IP Performance  
The TCP/ IP performance of the Sun Quad FastEthernet PCI adapter can be  
increased by changing the TCP high water mark to 64K. This can be done with the  
nddutility as follows.  
1. As superuser (root), type:  
# ndd -set /dev/tcp tcp_xmit_hiwat 65535  
# ndd -set /dev/tcp tcp_recv_hiwat 65535  
# ndd -set /dev/tcp tcp_cwnd_max 65534  
The changes take effect immediately and affect all the networking interfaces in the  
system. The changes are lost when you reboot the system.  
Chapter 3  
Configuring the Driver Software  
15  
 
                     
Forcing Network Speed Between 10 Mbps and 100  
Mbps  
1. At the okprompt, use the show-devscommand to list the system devices.  
You should see the full path names of the qfedevices, similar to the example below:  
/pci@1f,2000/pci@2/SUNW,qfe@0,1  
/pci@1f,2000/pci@2/SUNW,qfe@1,1  
/pci@1f,2000/pci@2/SUNW,qfe@2,1  
/pci@1f,2000/pci@2/SUNW,qfe@3,1  
2. Type:  
ok nvedit  
3. Type the following, pressing the Return key at the end of line 0:  
0: probe-all install-console banner  
1: apply transfer-speed=10 (full path name of a qfedevice)  
Note – If you already have commands in NRAM, append these lines to the end of  
the file.  
4. Press the Control-C keys after typing (full path name of a qfedevice).  
You will need to perform Steps 2 to 4 to set the network speed for each qfechannel.  
Note – In the above example, the speed is forced to 10 Mbps. To force the speed to  
100 Mbps, replace 10 with 100.  
5. At the okprompt type:  
ok nvstore  
ok setenv use-nvramrc? true  
6. Reboot your system.  
See Appendix C, “Configuring the Quad FastEthernet Device Driver Parameters,”  
for more information on forcing network speed.  
16  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
         
Auto-Negotiation  
A key feature of the Sun Quad FastEthernet PCI adapter is auto-negotiation. The  
auto-negotiation protocol, as specified by the 100BASE-T standard, selects the  
operation mode (half-duplex or full-duplex), and the auto-sensing protocol selects  
the speed (10 Mbps or 100 Mbps) for the adapter.  
The link speed and modes supported by the Sun Quad FastEthernet PCI adapter are  
listed as follows in decreasing order of priority:  
100 Mbps, full-duplex  
100 Mbps, half-duplex  
10 Mbps, full-duplex  
10 Mbps, half-duplex  
When the system is booted, the Sun Quad FastEthernet PCI adapter advertises these  
capabilities to the Link Partner at the other end of the link (a hub, switch, or another  
network interface card (NIC) in a host system). If the Link Partner also supports  
auto-negotiation, it will advertise its capabilities over the link. The common highest  
priority mode supported by both sides will be selected automatically for the link  
operation.  
The qfedevice driver operates the SUNW,qfedevices by default in half-duplex  
mode only. If the Sun Quad FastEthernet PCI adapter is connected to a remote  
system or interface that is not capable of auto-negotiation, your system  
automatically selects the speed and half-duplex mode.  
If the Sun Quad FastEthernet PCI adapter is connected to a link partner with which  
the auto-negotiation protocol fails to operate successfully, you can configure the  
device to not use this protocol and force the driver to set up the link in the mode and  
speed of your choice.  
Chapter 3  
Configuring the Driver Software  
17  
 
             
local-mac-addressProperty  
Each of the network interfaces of the Sun Quad FastEthernet PCI adapter have been  
assigned a unique MAC (Media Access Control) address, which represents the 48-bit  
ethernet address for that channel. The OpenBoot firmware reports this MAC address  
via the local-mac-addressproperty in the device nodes corresponding to the  
network interfaces.  
A system is not obligated to use this assigned MAC address if it has a system-wide  
MAC address. In such cases, the system-wide MAC address applies to all network  
interfaces on the system.  
The device driver, or any other adapter utility, can use the network device's MAC  
address (local-mac-address) while configuring it. In the Solaris 2.6 operating  
system (and later Solaris revisions), you will be able to use a channel's MAC address  
when booting over the network.  
The mac-addressproperty of the network device specifies the network address  
(system-wide or local-mac-address) used for booting the system. To start using  
the MAC addresses assigned to the network interfaces of the Sun Quad FastEthernet  
PCI adapter, set the NVRAM configuration variable local-mac-address?to  
true.  
ok setenv local-mac-address? true  
18  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
         
APPENDIX  
A
Specifications  
Physical Dimensions  
TABLE A-1 Physical Dimensions  
Assembly Dimension  
Length  
Measurement  
7.395 in (186.06 mm)  
4.759 in (120.88 mm)  
Width  
Height:  
Primary component side  
Back side  
0.570 in. (14.48 mm)  
0.105 in. (2.67 mm)  
5.2 oz (148 g)  
Weight  
19  
 
         
Power Requirements  
TABLE A-2 Power Requirements  
Specification  
Measurement  
14 Watts  
Maximum Power Dissipation  
Maximum Power Consumption  
Voltage Tolerance  
2.8 Amps @ 5V  
5V +/ - 5%  
Ripple  
Maximum 100 mV  
5V, 2.0 Amps  
Operational Current  
Performance Specifications  
TABLE A-3 Performance Specifications  
Specification  
Performance  
Maximum Ethernet Transfer Rate  
Host Interface  
10/ 100 Mbps per channel  
256-pin PBGA PCI to PCI bridge with a 64-bit primary and 32-bit  
secondary interface.  
Operates transparently in either 64-bit or 32-bit slots via a PCI specific  
Universal 64-bit Card Edge.  
Supports both 3.3v and 5v signalling environments.  
Fully compliant with PCI Local Bus Spec., Rev. 2.1.  
Network Interface  
100BASE-TX using Category 5 (data-grade) cable;  
10BASE-T using Category 3 (voice-grade) cable or better  
Single UTP RJ-45 for both 10 and 100 Mbps per channel  
Ethernet Version  
PCI clock  
Conforms to IEEE 802.3u  
33 MHz max.  
133 MB/ sec.  
PCI data burst transfer rate  
PCI Data/ Address Lines  
PCI modes  
AD63-0  
Master/ slave  
20  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
           
APPENDIX  
B
Interface Signals  
Ethernet channels  
0
1
2
3
1
8 9 16 17 24 25 32  
FIGURE B-1 32-Pin RJ-45 Connectors  
TABLE B-1 Pin Descriptions for the 32-Pin RJ-45 Connectors: Channels 0 - 3  
Description  
TD+  
CH0  
1
CH1  
9
CH2  
17  
18  
19  
20  
21  
22  
23  
24  
CH3  
25  
26  
27  
28  
29  
30  
31  
32  
TD–  
2
10  
11  
12  
13  
14  
15  
16  
RD+  
3
Not Used  
Not Used  
RD–  
4
5
6
Not Used  
Not Used  
7
8
21  
 
         
22  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
APPENDIX  
B
Configuring the Quad FastEthernet  
Device Driver Parameters  
The qfedevice driver controls the Sun Quad FastEthernet PCI adapters SUNW,qfe  
Ethernet devices. You can manually configure the qfedevice driver parameters to  
customize each SUNW,qfedevice in your system. This appendix provides an  
overview of the internal transceiver used in the adapter, lists the available qfe  
device driver parameters, and describes how you can configure these parameters.  
Internal Transceiver  
The four SUNW,qfechannels provide 10BASE-TX or 100BASE-T networking  
interfaces using the PCI Fast Ethernet and Expansion (PFEX) ASIC and an internal  
transceiver. The driver automatically sets the link speed to 10 or 100 Mbps and  
conforms to the 100BASE-T IEEE 802.3u Ethernet standard. The PFEX ASIC provides  
the PCI interface and Media Access Control (MAC) functions. The internal  
transceiver, which connects to an RJ-45 connector, provides the physical layer  
functions.  
The internal transceiver is capable of all the operating speeds and modes listed in  
the section, “Auto-Negotiation” on page 17. The internal transceiver performs auto-  
negotiation with the remote end of the link (link partner) to select a common mode  
of operation.  
The internal transceiver also supports a forced mode of operation. You can select the  
speed and mode using the nddutility, by editing the /etc/systemfile, or creating  
a qfe.conffile.  
23  
 
                     
Driver Parameter Values and Definitions  
This section describes the parameters and settings for the qfedevice driver.  
TABLE B-1 lists these parameters.  
TABLE B-1 qfeDriver Parameter, Status, and Descriptions  
Parameter  
Status  
Description  
transceiver_inuse  
link_status  
link_speed  
link_mode  
Read only  
Defines the current status  
Defines the current status  
Defines the current status  
Defines the current status  
Inter-packet gap parameter  
Inter-packet gap parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Read only  
Read only  
Read only  
ipg1  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read only  
ipg2  
use_int_xcvr  
pace_size  
adv_autoneg_cap  
adv_100fdx_cap  
adv_100hdx_cap  
adv_10fdx_cap  
adv_10hdx_cap  
autoneg_cap  
Local transceiver auto negotiation  
capability  
100fdx_cap  
100hdx_cap  
10fdx_cap  
10hdx_cap  
Read only  
Read only  
Read only  
Read only  
Local transceiver capability of  
the hardware  
Local transceiver capability of  
the hardware  
Local transceiver capability of  
the hardware  
Local transceiver capability of  
the hardware  
lp_autoneg_cap  
lp_100fdx_cap  
lp_100hdx_cap  
Read only  
Read only  
Read only  
Link partner auto negotiation capability  
Link partner capability  
Link partner capability  
24  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
         
TABLE B-1 qfeDriver Parameter, Status, and Descriptions (Continued)  
Parameter  
Status  
Description  
lp_10fdx_cap  
lp_10hdx_cap  
instance  
Read only  
Link partner capability  
Link partner capability  
Device instance  
Read only  
Read and write  
Read and write  
lance_mode  
Additional delay before transmitting  
a packet  
ipg0  
Read and write  
Additional delay before transmitting  
Defining the Current Status  
The read-only parameters described in TABLE B-2 explain the operational mode of the  
interface. These parameters define the current status.  
TABLE B-2 Read-Only Parameters Defining the Current Status  
Parameter  
Values  
Description  
link_status  
Current link status  
= Link down  
= Link up  
0
1
link_speed  
link_mode  
Valid only if the link is up  
= 10 Mbps  
= 100 Mbps  
0
1
Valid only if the link is up  
= Half duplex  
= Full duplex  
0
1
Inter-Packet Gap Parameters  
The PCI Fast Ethernet and Expansion (PFEX) ASIC supports the programmable  
Inter-Packet Gap (IPG) parameters ipg1and ipg2. The total IPG is the sum of ipg1  
and ipg2. The total IPG is 9.6 microseconds when the link speed set, by the auto-  
negotiation protocol, is 10 Mbps. When the link speed is 100 Mbps, the total IPG is  
0.96 microseconds.  
Appendix B  
Configuring the Quad FastEthernet Device Driver Parameters  
25  
 
               
TABLE B-3 lists the default values and allowable values for the inter-packet gap (IPG)  
parameters, ipg1and ipg2.  
TABLE B-3 Read-Write Inter-Packet Gap Parameter Values and Descriptions  
Parameter  
Values  
Description  
(Byte-time)  
ipg1  
ipg2  
0, 255  
0, 255  
ipg1= 8 (default at initialization)  
ipg2= 4 (default at initialization)  
By default, the driver sets ipg1to 8-byte time and ipg2to 4-byte time, which are  
the standard values. (Byte time is the time it takes to transmit one byte on the link,  
with a link speed of either 100 Mbps or 10 Mbps.)  
If your network has systems that use longer IPG (the sum of ipg1and ipg2) and if  
those machines seem to be slow in accessing the network, increase the values of  
ipg1and ipg2to match the longer IPGs of other machines.  
Defining an Additional Delay Before Transmitting  
a Packet Using lance_modeand ipg0  
The PCI Fast Ethernet and Expansion (PFEX) ASIC supports a programmable mode  
called lance_mode. The ipg0parameter is associated with lance_mode.  
After a packet is received with lance_modeenabled (default) an additional delay is  
added by setting the ipg0parameter before transmitting the packet. This delay, set  
by the ipg0parameter, is in addition to the delay set by the ipg1and ipg2  
parameters. The additional delay set by ipg0helps to reduce collisions. Systems  
that have lance_modeenabled might not have enough time on the network.  
If lance_modeis disabled, the value of ipg0is ignored and no additional delay is  
set. Only the delays set by ipg1and ipg2are used. Disable lance_modeif other  
systems keep sending a large number of back-to-back packets.  
You can add the additional delay by setting the ipg0parameter from 0 to 31, which  
is the nibble time delay. Note that nibble time is the time it takes to transfer four bits  
on the link. If the link speed is 10 Mbps, nibble time is equal to 400 ns. If the link  
speed is 100 Mbps, nibble time is equal to 40 ns.  
For example, if the link speed is 10 Mbps, and you set ipg0to 20 nibble times,  
multiply 20 by 400 ns to get 800 ns. If the link speed is 100 Mbps, and you set ipg0  
to 30 nibble-times, multiply 30 by 40 ns to get 120 ns.  
26  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
                     
TABLE B-4 defines the lance_modeand ipg0parameters.  
TABLE B-4 Parameters Defining lance_modeand ipg0  
Parameter  
Values  
Description  
lance_mode  
0
1
lance_modedisabled  
lance_modeenabled (default)  
1
ipg0  
0-31  
Additional IPG before transmitting a packet  
(after receiving a packet)  
1. The default value is 16 nibble-times, which is 6.4 microseconds for 10 Mbps and 0.64 microseconds  
Operational Mode Parameters  
TABLE B-5 describes the operational mode parameters and their default values.  
TABLE B-5 Operational Mode Parameters  
Parameter  
Values  
Description  
adv_autoneg_cap  
Local transceiver capability advertised by the hardware  
= Forced mode  
= Auto-negotiation (default)  
0
1
1
adv_100fdx_cap  
Local transceiver capability advertised by the hardware;  
read/ write parameter  
0
1
= Not 100Mbit/ sec full-duplex capable (default in the Solaris  
2.5 and 2.5.1 software environments)  
= 100Mbit/ sec full-duplex capable (default in the Solaris 2.6  
software environment)  
1
adv_100hdx_cap  
Local transceiver capability advertised by the hardware;  
read/ write parameter  
0
1
= Not 100Mbit/ sec half-duplex capable  
= 100Mbit/ sec half-duplex capable (default)  
1
adv_10fdx_cap  
Local transceiver capability advertised by the hardware;  
read/ write parameter  
0
1
= Not 10Mbit/ sec full-duplex capable (default)  
= 10Mbit/ sec full-duplex capable  
1
adv_10hdx_cap  
Local transceiver capability advertised by the hardware;  
read/ write parameter  
0
1
= Not 10Mbit/ sec half-duplex capable  
= 10Mbit/ sec half-duplex capable (default)  
1. The priority (in descending order) for these parameters is: adv_100fdx_cap, adv_100hdx_cap, adv_10fdx_cap, and  
adv_10hdx_cap.  
Appendix B  
Configuring the Quad FastEthernet Device Driver Parameters  
27  
 
           
Defining the Number of Back-to-Back Packets to  
Transmit  
The pace_sizeparameter (see TABLE B-6) defines the maximum number of back-to-  
back packets you can transmit at one time. If the value is zero, there is no limit to the  
number of back-to-back packets that can be transmitted.  
TABLE B-6 Back-to-back Packet Transmission Capability  
Parameter  
Values  
Description  
pace_size  
1 to 255  
=
=
Number of back-to-back packets transmitted at one time  
0
No limit to the number of back-to-back packets that can be  
transmitted (default)  
Reporting Transceiver Capabilities  
TABLE B-7 describes the read-only transceiver capabilities. These parameters define  
the capabilities of the hardware. The internal transceiver can support all of these  
capabilities.  
TABLE B-7 Read-Only Transceiver Capabilities  
Parameter  
Values Description  
autoneg_cap  
Local transceiver capability of the hardware  
0
1
= Not capable of auto-negotiation  
= Auto negotiation capable  
100fdx_cap  
100hdx_cap  
10fdx_cap  
10hdx_cap  
Local transceiver capability of the hardware; initialized at startup  
= Not 100Mbit/ sec full-duplex capable  
= 100Mbit/ sec full-duplex capable  
0
1
Local transceiver capability of the hardware; initialized at startup  
= Not 100Mbit/ sec half-duplex capable  
= 100Mbit/ sec half-duplex capable  
0
1
Local transceiver capability of the hardware; initialized at startup  
= Not 10Mbit/ sec full-duplex capable  
= 10Mbit/ sec full-duplex capable  
0
1
Local transceiver capability of the hardware; initialized at startup  
= Not 10Mbit/ sec half-duplex capable  
= 10Mbit/ sec half-duplex capable  
0
1
28  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
             
Reporting the Link Partner Capabilities  
TABLE B-8 describes the read-only link partner capabilities.  
TABLE B-8 Read-Only Link Partner Capabilities  
Parameter  
Values  
Description  
lp_autoneg_cap  
0
1
= No auto-negotiation  
= Auto-negotiation  
lp_100fdx_cap  
lp_100hdx_cap  
lp_10fdx_cap  
lp_10hdx_cap  
0
1
= No100Mbit/ sec full-duplex transmission  
= 100Mbit/ sec full-duplex  
0
1
= No 100Mbit/ sec half-duplex transmission  
= 100Mbit/ sec half-duplex  
0
1
= No 10Mbit/ sec full-duplex transmission  
= 10Mbit/ sec full-duplex  
0
1
= No 10Mbit/ sec half-duplex transmission  
= 10Mbit/ sec half-duplex  
If the link partner is not capable of auto-negotiation (when lp_autoneg_capis 0)  
the information described in TABLE B-8 is not relevant and the parameter value = 0.  
If the link partner is capable of auto-negotiation (when lp_autoneg_capis 1) then  
the speed and mode information is displayed when you use auto-negotiation and  
get the link partner capabilities.  
Appendix B  
Configuring the Quad FastEthernet Device Driver Parameters  
29  
 
       
Setting qfeDriver Parameters  
You can set the qfedevice driver parameters in three ways (ndd, /etc/system,  
and qfe.conf), depending on your needs. To set parameters that are valid until you  
reboot the system, use the nddutility. Using nddis a good way to test parameter  
settings.  
To set parameters so they remain in effect after you reboot the system:  
Add the parameter values to the /etc/systemfile when you want to configure  
parameters for all devices in the system.  
Create a /kernel/drv/qfe.conffile and add parameter values to the this file  
when you need to set a particular parameter for a device in the system.  
Setting Parameters Using the nddUtility  
Use the nddutility to configure parameters that are valid until you reboot the  
system. The nddutility supports any networking driver, which implements the Data  
Link Provider Interface (DLPI).  
The following sections describe how you can use the qfedriver and the nddutility  
to modify (with the -setoption) or display (without the -setoption) the  
parameters for each SUNW,qfedevice.  
Identifying Device Instances  
Before you use the nddutility to get or set a parameter for a qfedevice, you must  
specify the device instance for the utility since there will be at least four SUNW,qfe  
devices.  
30  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
             
To Specify the Device Instance for the nddUtility  
1. Check the /etc/path_to_instfile to identify the instance associated with a  
particular device.  
# grep qfe /etc/path_to_inst  
"/pci@1f,2000/pci@2/SUNW,qfe@0,1" 4 "qfe"  
"/pci@1f,2000/pci@2/SUNW,qfe@1,1" 5 "qfe"  
"/pci@1f,2000/pci@2/SUNW,qfe@2,1" 6 "qfe"  
"/pci@1f,2000/pci@2/SUNW,qfe@3,1" 7 "qfe"  
In the example above, the four SUNW,qfe@x,1instances are from a Sun Quad  
FastEthernet PCI adapter installed in slot 2. For clarity, the instance numbers are  
bold.  
2. Use the instance number to select the device.  
# ndd -set /dev/qfe instance instance#  
The device remains selected until you change the selection.  
Non-Interactive and Interactive Modes  
You can use the nddutility in two modes:  
Non-interactive  
Interactive  
In non-interactive mode, you invoke the utility to execute a specific command. Once  
the command is executed, you exit the utility. In interactive mode, you can use the  
utility to get or set more than one parameter value. (Refer to the ndd(1M) man page  
for more information.)  
Appendix B  
Configuring the Quad FastEthernet Device Driver Parameters  
31  
 
     
Using the nddUtility in Non-Interactive Mode  
This section describes how to modify and to display parameter values.  
To modify a parameter value, use the -setoption.  
If you invoke the nddutility with the -setoption, the utility passes value, which  
must be specified down to the named /dev/qfedriver instance, and assigns it to  
the parameter:  
# ndd -set /dev/qfe parameter value  
To display the value of a parameter, specify the parameter name (and omit the  
value).  
When you omit the -setoption, a query operation is assumed and the utility  
queries the named driver instance, retrieves the value associated with the specified  
parameter, and prints it:  
# ndd /dev/qfe parameter  
Using the nddUtility in Interactive Mode  
To modify a parameter value in interactive mode, specify ndd /dev/qfe, as  
shown below.  
The nddutility then prompts you for the name of the parameter:  
# ndd /dev/qfe  
name to get/set? (Enter the parameter name or ?to view all parameters)  
After entering the parameter name, the nddutility prompts you for the parameter  
value (see TABLE B-1 through TABLE B-8).  
32  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
     
To list all the parameters supported by the qfedriver, type ndd /dev/qfe \?.  
(See TABLE B-1 through TABLE B-8 for parameter descriptions.)  
# ndd /dev/qfe \?  
?
(read only)  
transceiver_inuse  
link_status  
link_speed  
link_mode  
(read only)  
(read only)  
(read only)  
(read only)  
ipg1  
ipg2  
use_int_xcvr  
pace_size  
adv_autoneg_cap  
adv_100fdx_cap  
adv_100hdx_cap  
adv_10fdx_cap  
adv_10hdx_cap  
autoneg_cap  
100fdx_cap  
100hdx_cap  
10fdx_cap  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read only)  
(read only)  
(read only)  
(read only)  
10hdx_cap  
(read only)  
lp_autoneg_cap  
lp_100fdx_cap  
lp_100hdx_cap  
lp_10fdx_cap  
lp_10hdx_cap  
instance  
(read only)  
(read only)  
(read only)  
(read only)  
(read only)  
(read and write)  
(read and write)  
(read and write)  
lance_mode  
ipg0  
#
FIGURE B-1 Example of Listing All Parameters Supported by the qfeDriver  
Appendix B  
Configuring the Quad FastEthernet Device Driver Parameters  
33  
 
 
Setting Forced Mode  
This section describes how to set forced mode (not capable of auto-negotiation).  
To Select One Local Transceiver Capability and Setting  
Forced Mode  
1. Select one of the following capabilities: adv_100fdx_cap, adv_100hdx_cap,  
adv_10fdx_cap, or adv_10hdx_cap, and set its value to 1.  
If you select more than one of the local transceiver capabilities, the driver selects the  
one that is highest in the priority order (see the footnote from TABLE B-5 on page 27).  
2. Set the local transceiver capabilities advertised by the hardware to forced  
mode = 0, which is not capable of auto-negotiation: adv_autoneg_cap 0  
Use the nddutility as described in “Using the nddUtility in Interactive Mode” on  
page 32.  
Auto-Negotiation Mode  
This section describes how to select at least one of the four local transceiver  
capabilities and set the mode to auto-negotiation.  
To Set the Mode to Auto-Negotiation  
1. Select at least one of the five capabilities (adv_100fdx_cap, adv_100hdx_cap,  
adv_10fdx_cap, adv_10hdx_cap) that you want to advertise to the remote  
system, and set its value to 1.  
2. Set the local transceiver capabilities advertised by the hardware to 1, the auto-  
negotiation setting: adv_autoneg_cap 1  
Use the nddutility as described in “Using the nddUtility in Interactive Mode” on  
page 32.  
34  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
             
Setting Parameters in the /etc/system  
File  
To configure the qfedriver parameters for all SUNW,qfedevices in the system so  
that the parameter variables are always effective (even after rebooting the system),  
enter the parameter variables in the /etc/systemfile. When you reboot the system,  
the system reads the /etc/systemfile and sets these parameter variables in the  
qfemodule in the operating system kernel.  
TABLE B-9 lists the variables you can set in the /etc/systemfile.  
TABLE B-9 Setting Variables in the /etc/systemFile  
Parameter  
Variable  
ipg1  
qfe_ipg1  
ipg2  
qfe_ipg2  
use_int_xcvr  
pace_size  
adv_autoneg_cap  
adv_100fdx_cap  
adv_100hdx_cap  
adv_10fdx_cap  
lance_mode  
ipg0  
qfe_use_int_xcvr  
qfe_pace_size  
qfe_adv_autoneg_cap  
qfe_adv_100fdx_cap  
qfe_adv_100hdx_cap  
qfe_adv_10hdx_cap  
qfe_lance_mode  
qfe_ipg0  
These parameter values, described in “Driver Parameter Values and Definitions” on  
page 24, are applicable to all SUNW,qfedevices on the system. See TABLE B-1 through  
TABLE B-8 for the descriptions of these parameters.  
Appendix B  
Configuring the Quad FastEthernet Device Driver Parameters  
35  
 
         
Heres an example of setting parameters in a /etc/systemfile:  
Setting the ipg1and ipg2Parameters in the  
/etc/systemFile  
1. Become superuser.  
2. Add the following lines to the /etc/systemfile:  
set qfe:qfe_ipg1 = 10  
set qfe:qfe_ipg2 = 5  
3. Save the /etc/systemfile.  
4. Save all files and exit all programs, exit the windowing system.  
5. Reboot the system by typing init 6at the superuser prompt.  
qfe.confFile  
You can also specify the properties described in the section, “Setting Parameters in  
the /etc/systemFile,” on a per-device basis by creating a qfe.conffile in the  
/kernel/drvdirectory. The properties set in the qfe.conffile will override the  
parameters set in the /etc/systemfile. Use a qfe.conffile when you need to set  
a particular parameter for a device in the system. The parameters you set are read  
and write parameters that are listed in “Driver Parameter Values and Definitions” on  
page 24.  
The man pages for prtconf(1M), system(4) and driver.conf(4) include  
additional details. The next section shows an example of setting parameters in a  
qfe.conffile.  
36  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
           
Setting ipgDriver Parameters Using a qfe.conf  
File  
1. Obtain the hardware path names for the qfedevices in the device tree.  
Typically the path names and the associated instance numbers will be present in the  
/etc/path_to_instfile.  
# grep qfe /etc/path_to_inst  
"/pci@1f,2000/pci@2/SUNW,qfe@0,1" 4 "qfe"  
"/pci@1f,2000/pci@2/SUNW,qfe@1,1" 5 "qfe"  
"/pci@1f,2000/pci@2/SUNW,qfe@2,1" 6 "qfe"  
"/pci@1f,2000/pci@2/SUNW,qfe@3,1" 7 "qfe"  
In the above lines:  
The first part within the double quotes specifies the hardware node name in the  
device tree.  
The second number is the instance number.  
The last part in double quotes is the driver name.  
In the device path name, the last component after the last /character and before  
the @character is the device name.  
The path name before the last component is the parent name.  
The comma separated numbers after the @character at the end represent the  
device and function numbers, which are together referred to as unit-address.  
To identify a PCI device unambiguously in the qfe.conffile, use the name, parent  
name, and the unit-address for the device. Refer to the pci(4) man page for more  
information about the PCI device specification.  
In the first line of the previous example:  
Name = SUNW,qfe  
Parent = /pci@1f,2000/pci@2  
Unit-address = 0,1  
In the second line in the previous example:  
Name = SUNW,qfe  
Parent = /pci@1f,2000/pci@2  
Unit-address = 1,1  
Appendix B  
Configuring the Quad FastEthernet Device Driver Parameters  
37  
 
         
In the third line in the previous example:  
Name = SUNW,qfe  
Parent = /pci@1f,2000/pci@2  
Unit-address = 2,1  
In the fourth line in the previous example:  
Name = SUNW,qfe  
Parent = /pci@1f,2000/pci@2  
Unit-address = 3,1  
2. Set the ipg1and ipg2parameters for the above four devices in the  
/kernel/drv/qfe.conffile.  
name = “SUNW,qfe” parent = “/pci@1f,2000/pci@2” unit-address = “0,1” ipg1=20 ipg2=10;  
name = “SUNW,qfe” parent = “/pci@1f,2000/pci@2” unit-address = “1,1” ipg1=20 ipg2=10;  
name = “SUNW,qfe” parent = “/pci@1f,2000/pci@2” unit-address = “2,1” ipg1=20 ipg2=10;  
name = “SUNW,qfe” parent = “/pci@1f,2000/pci@2” unit-address = “3,1” ipg1=20 ipg2=10;  
3. Save the qfe.conffile.  
4. Save and close all files and programs, and exit the windowing system.  
5. Halt and reboot the system by typing the init 6command at the superuser  
prompt.  
38  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
     
APPENDIX  
D
Running Diagnostics Tests  
This appendix describes how to test the Sun Quad FastEthernet PCI adapter with its  
FCode PROM selftest.  
Note – To test the Sun Quad FastEthernet PCI adapter further, refer to the SunVTS  
Users Guide that shipped with your operating system.  
Using the OpenBoot PROM FCode  
Selftest  
The following tests are available to help identify problems with the Sun Quad  
FastEthernet PCI adapter if the system does not boot.  
You can invoke the FCode selftestdiagnostics by using the OpenBoot user  
interface testor test-allcommands. If you encounter an error while running  
diagnostics, appropriate messages will be displayed. Refer to the OpenBoot 3.x  
Command Reference Manual for more information on the testand test-all  
commands.  
The selftestexercises most functionality sub-section by sub-section and ensures  
the following:  
Isolates faulty field replaceable units (FRUs)  
Checks, with a high confidence, that no hardware fault exists on  
No Trouble Found (NTF)  
Checks connectivity during adapter card installation  
Verifies that all components are functional  
39  
 
           
Running the Ethernet FCode Selftest Diagnostic  
To run the ethernet diagnostics, you must first bring the system to a stop at the  
OpenBoot prompt after issuing a reset. If you do not reset the system, the diagnostic  
tests may cause the system to hang.  
For more information about the OpenBoot commands in this section, refer to the  
OpenBoot 3.x Command Reference manual.  
1. Shut down the system.  
Use the standard shut down procedures described in Solaris 2.x Handbook for SMCC  
Peripherals.  
2. At the okprompt, set the auto-boot?configuration variable to false.  
ok setenv auto-boot? false  
3. Reset the system.  
ok reset-all  
4. Type show-devsto display the list of devices.  
You should see lines in the list of devices, similar to the example below, specific to  
the Sun Quad FastEthernet PCI adapter:  
ok show-devs  
. . .  
/pci@1f,2000/pci@2/SUNW,qfe@0,1  
/pci@1f,2000/pci@2/SUNW,qfe@1,1  
/pci@1f,2000/pci@2/SUNW,qfe@2,1  
/pci@1f,2000/pci@2/SUNW,qfe@3,1  
. . .  
In this example, the SUNW,qfe@x,1entries identify the device paths to the four  
Ethernet channels.  
5. Type the following to put the OpenBoot PROM into diagnostic mode:  
ok setenv diag-switch? true  
40  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
   
6. Type the following to run the selftest using the testcommand on one of the  
adapters four Ethernet channels:  
ok test <device path>  
The following tests are run when the testcommand is executed:  
hmeregister  
MAC internal loopback  
External loopback  
100 Mbps PHY loopback  
10 Mbps PHY loopback  
If the test passes, you will see these messages:  
Hme register test --- succeeded.  
Internal loopback test -- succeeded  
Transceiver check -- Using onboard transceiver -- Link up  
passed  
If the channel is not connected to a network, you will see the following error  
messages:  
Hme register test --- succeeded.  
Internal loopback test -- succeeded  
Transceiver check -- Using onboard transceiver -- Link down  
Autonegotiation timeout  
Check Cable or contact system administrator  
Failed  
selftest failed. return code = -1  
Note – To test other channels of the adapter, you will need to execute the test  
command separately on each channel.  
7. After testing the adapter, type the following to return the OpenBoot PROM to  
standard operating mode:  
ok setenv diag-switch? false  
Appendix D  
Running Diagnostics Tests  
41  
 
8. Set the auto-boot?configuration parameter to true.  
ok setenv auto-boot? true  
9. Reset and reboot the system.  
ok reset-all  
42  
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
Index  
/etc/hostsfile  
editing, 11  
A
example, 13  
/etc/systemfile, setting parameters, 35  
B
booting  
from network, 14  
reconfiguration, 9  
F
C
H
D
hardware  
declaration of conformity, v  
driver parameters, 24  
driver_aliasesfile, 5  
examining network activity, 8  
features, 2  
product overview, 1  
E
editing  
editing, 11  
/etc/hostsfile, 11  
/etc/systemfile, 15, 35  
driver_aliasesfile, 5  
hostname.qfe# files, 11  
qfe.conffile, 15, 36  
example, 13  
hostname.qfe# files  
creating, 12  
editing, 11  
examples, 13  
Index  
43  
 
full-duplex, 17  
I
hardware, 6  
instance numbers, finding, 12, 37  
interface signals, 21  
P
internal transceiver, 23, 28  
performance specifications, 20  
physical dimensions, 19  
pin descriptions, 21  
L
lance_mode, 26  
power requirements, 20  
LEDs, 2  
local-mac-address?variable, 18  
Q
M
defining current status, 25  
lance_mode, 26  
N
operational mode parameters, 27  
parameters, 24  
reporting  
selecting a device, 31  
setting forced mode, 34  
setting qfeparameters, 30  
link partner capabilities, 29  
transceiver capabilities, 28  
setting parameters, 30  
network speed, forcing between 10 and 100  
Mbps, 16, 27, 34  
nibble time delay, 26  
reconfiguration boot, 9  
related documents, xii  
ordering, xiv  
O
OpenBoot PROM  
displaying revision level, 3  
requirements, 3  
selftestdiagnostics, 39  
44 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
requirements  
hardware, 3  
W
watch-net-alloutput, 8  
OpenBoot PROM, 3  
software, 3  
RJ-45 connectors, 21, 23  
S
selftestdiagnostics, 39  
software  
adding an additional delay, 26  
configuring  
driver parameters, 15, 23 to 38  
host files, 11  
editing driver_aliasesfile, 5  
specifications  
performance, 20  
physical dimensions, 19  
power requirements, 20  
Sun Quad FastEthernet 2.0 CD-ROM, 11  
SunDocs, xiv  
/etc/systemfile, setting parameters, 35  
T
TCP/ IP performance, increasing, 15  
testing  
SunVTS software, 39  
V
verifying hardware installation, 7  
Index  
45  
 
46 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997  
 
Ordering Sun Documents  
SunDocsSM is a distribution program for technical documentation and is available from SunExpress. To  
order or for more information:  
Country  
Belgium  
Canada  
France  
Phone  
Fax  
Country  
Phone  
Fax  
02-72-09-09  
1-800-873-7869  
0800-90-61-57  
01-30-81-61-31  
06-022-34-45  
0120-33-9096  
02-72-88-50  
1-800-944-0661  
080-90-61-58  
01-30-81-61-92  
06-022-34-46  
0120-33-9097  
Luxembourg  
Sweden  
32-2-72-09-09  
020-79-57-26  
0800-55-19-26  
0800-89-88-88  
1-800-873-7869  
32-2-725-88-50  
020-79-57-27  
0800-55-19-27  
0800-89-88-87  
1-800-944-0661  
Switzerland  
United Kingdom  
United States  
Germany  
Holland  
Japan  
Sun Welcomes Your Comments  
We are interested in improving our documentation and welcome your comments. Use the reader  
comment card or send comments via email to: [email protected].  
You can also send a fax to SMCC Doc Feedback at 1-415 786-6443.  
Please include the part number of your document in the subject line of your email or fax message.  
 
AIR MAIL  
PAR AVION  
NE PAS AFFRANCHIR  
NO POSTAGE  
NECESSARY  
IF MAILED  
TO THE  
UNITED STATES  
IBRS/CCRI No. 808  
INTERNATIONAL BUSINESS REPLY MAIL/RESPONSE PAYEE  
PERMIT NO. 808  
MOUNTAIN VIEW CA  
POSTAGE WILL BE PAID BY ADDRESSEE  
INFORMATION PRODUCTS  
M/S MPK14-108  
SUN MICROSYSTEMS INC  
2550 GARCIA AVE  
MOUNTAIN VIEW CA 94043-9551  
UNITED STATES OF AMERICA  
 

Silvercrest Computer Drive JS 101 User Manual
Snapper Air Cleaner 31H700 User Manual
Sony DVD Recorder DSR 70 User Manual
Sony Stereo Amplifier XM 5046 3546 User Manual
Sony Stereo System 4 130 433 132 User Manual
Spalding Fitness Equipment M6620241 User Manual
Sunbeam Hot Beverage Maker KE1400 User Manual
Sungale Computer Keyboard KB002 User Manual
Swisher Log Splitter LS422X User Manual
Sylvania Flat Panel Television 6626LG User Manual