Sun Microsystems Sun Quad manual

2550 Garcia A venue Mountain V iew , CA 94043 USA 415 960-1300 fax 415 969-9131 A Sun Microsystems, Inc. Business Sun ™ Quad FastEthernet ™ PCI Adapter Installation and User ’s Guide Part No.: 805-1797-10 Revision A, August 1997 Sun Microsystems Computer Company[...]

Please Recycle Copyright 1997 Sun Microsystems, Inc. 2550 Garcia A venue, Mountain V iew , California 94043-1 100 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 fo[...]

Regulatory Compliance Statements iii Regulatory Compliance Statements Your Sun product is marked to indicate its compliance class: • Federal Communications Commission (FCC) — USA • Department of Communications (DOC) — Canada • V oluntary Control Council for Interference (VCCI) — Japan Please read the appropriate section that corresponds[...]

iv Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 DOC Class A Notice - A vis 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 brouilleu[...]

Declaration of Conf or mity v 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) Class A EN50082-1 IEC801-2 [...]

vi Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997[...]

Contents vii Contents 1. Product Overview 1 Features 2 Hardwar e and Software Requir ements 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 V erifying the Installation 7 Examining Network Activity 8 Reboo[...]

viii Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997 Forcing Network Speed Between 10 Mbps and 100 Mbps 16 Auto-Negotiation 17 local-mac-address Property 18 A. Specif ications 19 Physical Dimensions 19 Power Requirements 20 Performance Specifications 20 B. Interface Signals 21 C. Conf iguring the Quad FastEthernet [...]

Contents ix Setting Parameters Using the qfe.conf File 36 Setting ipg Driver Parameters Using a qfe.conf File 37 D. Running Diagnostics T ests 39 Using the OpenBoot PROM FCode Selftest 39 ▼ Running the Ethernet FCode Selftest Diagnostic 40[...]

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

Preface xi Pr eface 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 configur e the Sun Quad FastEthernet driver software. These instructions are designed for system administrators with experience installing [...]

xii Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997 Related Documents The following documents contain topics that relate to the information in the Sun Quad FastEthernet PCI Adapter Installation and User ’ s Guide . UNIX Commands This document may not include specific softwar e commands or procedures. Instead, it [...]

Preface xiii T ypographic Conventions The following table describes the typographic changes used in this book. Shell Pr ompts The following table shows the default system prompt and super user prompt for the C shell, Bourne shell, and Korn shell. T ypeface or Symbol Meaning Example AaBbCc123 The names of commands, files, and directories; on-scr een[...]

xiv Sun Quad FastEthernet PCI Adapter Installation and User’s Guide • August 1997 Or dering Sun Documents SunDocs SM is a distribution program for Sun Microsystems technical documentation. Contact SunExpress for easy or dering and quick delivery . Y ou can find a listing of available Sun documentation on the W orld W ide W eb. Sun W elcomes Y o[...]

1 CHAPTER 1 Pr oduct 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 . FIGURE 1-1 Sun Quad FastEthernet PCI adapter PCI Connector Ethernet Connectors[...]

2 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 FIGURE 1-2 Sun Quad FastEthernet PCI adapter Back Panel Featur es This PCI adapter offers the following featur es: ■ Fully complies with the ANSI/IEEE std. 802.3 CSMA/CD physical layer specification ■ Four Switchable 10BASE-T/100BASE-TX Ethernet channels with a[...]

Chapter 1 Product Ov erview 3 Har dwar e and Softwar e Requir ements Before installing the adapter , make sure your system meets the following hardwar e and software r equirements: Note – The information above is up-to-date as of the printing of this manual. V isit Sun on the W orld W ide W eb at http://www.sun.com/ for the latest information. Ch[...]

4 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997[...]

5 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_aliases File If your system is running the Solaris 2.5.1 Hardwar e: 4/97 operating environment, you will need to add an entry to the /etc[...]

6 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 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 t[...]

Chapter 2 Installing the Adapter 7 V erifying 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[...]

8 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 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-all command. Make sure that the interfaces ar e co[...]

Chapter 2 Installing the Adapter 9 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 reconf iguration boot on the system. Refer to the Solaris 2.x Peripheral’ s Handbook for more informati[...]

10 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997[...]

11 CHAPTER 3 Conf iguring the Driver Softwar e This chapter describes how to configure the driver softwar e used by the Sun Quad FastEthernet PCI adapter . Installing the Driver Softwar e The Sun Quad FastEthernet 2.0 CD-ROM contains the software requir ed by the Sun Quad FastEthernet PCI adapter. Install the software driver packages as described i[...]

12 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 1. At the command line, use the grep command to search the /etc/path_to_inst f ile for qfe devices. In the example above, the four SUNW,qfe@ x ,1 instances are from a Sun Quad FastEthernet PCI adapter installed in slot 2. For clarity , the instance numbers are bol[...]

Chapter 3 Configuring the Driver Softw are 13 Using the instance examples in Step 1, the following example shows the four /etc/hostname.qfe <num> files r equired for a system called zardoz that has a Sun Quad FastEthernet PCI adapter ( zardoz-11 , zardoz-12 , zardoz-13 , and zardoz-14) . 3. Create an appropriate entry in the /etc/hosts f ile [...]

14 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 Booting Fr om the Network T o use a Sun Quad FastEthernet PCI adapter ethernet interface as the boot device, perform the following tasks: 1. At the ok prompt type: The show-devs command lists the system devices. Y ou should see the full path name of the qfe device[...]

Chapter 3 Configuring the Driver Softw are 15 Post-Installation Pr ocedur es (Optional) Perform the tasks in the following sections to customize the performance of the Sun Quad FastEthernet PCI adapter. Conf iguring Driver Parameters The qfe device driver , which is loaded from the CD-ROM, controls the SUNW,qfe Ethernet devices. The device driver a[...]

16 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 For cing Network Speed Between 10 Mbps and 100 Mbps 1. At the ok prompt, use the show-devs command to list the system devices. Y ou should see the full path names of the qfe devices, similar to the example below: 2. T ype: 3. T ype the following, pressing the Retu[...]

Chapter 3 Configuring the Driver Softw are 17 Auto-Negotiation A key feature of the Sun Quad FastEthernet PCI adapter is auto-negotiation. The auto-negotiation protocol, as specif ied 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 adap[...]

18 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 local-mac-address Pr operty Each of the network interfaces of the Sun Quad FastEthernet PCI adapter have been assigned a unique MAC (Media Access Control) addr ess, which represents the 48-bit ethernet address for that channel. The OpenBoot f irmware reports this [...]

19 APPENDIX A Specif ications Physical Dimensions T ABLE A-1 Physical Dimensions Assembly Dimension Measurement Length 7.395 in (186.06 mm) W idth 4.759 in (120.88 mm) Height: Primary component side 0.570 in. (14.48 mm) Back side 0.105 in. (2.67 mm) W eight 5.2 oz (148 g)[...]

20 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 Power Requir ements Performance Specif ications T ABLE A-2 Power Requir ements Specification Measurement Maximum Power Dissipation 14 W atts Maximum Power Consumption 2.8 Amps @ 5V V oltage T olerance 5V +/- 5% Ripple Maximum 100 mV Operational Current 5V , 2.0 Am[...]

21 APPENDIX B Interface Signals FIGURE B-1 32-Pin RJ-45 Connectors T ABLE B-1 Pin Descriptions for the 32-Pin RJ-45 Connectors: Channels 0 - 3 Description CH0 CH1 CH2 CH3 TD+ 1 9 17 25 T D – 2 1 01 82 6 RD+ 3 1 1 19 27 Not Used 4 12 20 28 Not Used 5 13 21 29 R D – 6 1 42 23 0 Not Used 7 15 23 31 Not Used 8 16 24 32 0123 Ethernet channels 18 9 1[...]

22 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997[...]

23 APPENDIX B Conf iguring the Quad FastEthernet Device Driver Parameters The qfe device driver controls the Sun Quad FastEthernet PCI adapter’s SUNW,qfe Ethernet devices. Y ou can manually configure the qfe device driver parameters to customize each SUNW,qfe device in your system. This appendix provides an overview of the internal transceiver us[...]

24 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 Driver Parameter V alues and Def initions This section describes the parameters and settings for the qfe device driver . T ABLE B-1 lists these parameters. T ABLE B-1 qfe Driver Parameter , Status, and Descriptions Parameter Status Description transceiver_inuse Re[...]

Appendix B Configuring the Quad F astEthernet Device Driv er Par ameters 25 Def ining the Current Status The read-only parameters described in T ABLE B-2 explain the operational mode of the interface. These parameters define the current status. Inter -Packet Gap Parameters The PCI Fast Ethernet and Expansion (PFEX) ASIC supports the programmable In[...]

26 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 T ABLE B-3 lists the default values and allowable values for the inter-packet gap (IPG) parameters, ipg1 and ipg2 . By default, the driver sets ipg1 to 8-byte time and ipg2 to 4-byte time, which are the standard values. (Byte time is the time it takes to transmit [...]

Appendix B Configuring the Quad F astEthernet Device Driv er Par ameters 27 T ABLE B-4 defines the lance_mode and ipg0 parameters. Operational Mode Parameters T ABLE B-5 describes the operational mode parameters and their default values. T ABLE B-4 Parameters Def ining lance_mode and ipg0 Parameter V alues Description lance_mode 0 1 lance_mode disa[...]

28 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 Def ining the Number of Back-to-Back Packets to T ransmit The pace_size parameter (see T ABLE 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[...]

Appendix B Configuring the Quad F astEthernet Device Driv er Par ameters 29 Reporting the Link Partner Capabilities T ABLE B-8 describes the read-only link partner capabilities. If the link partner is not capable of auto-negotiation (when lp_autoneg_cap is 0) the information described in T ABLE B-8 is not relevant and the parameter value = 0. If th[...]

30 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 Setting qfe Driver Parameters Y ou can set the qfe device driver parameters in three ways ( ndd , /etc/system , and qfe.conf ), depending on your needs. T o set parameters that are valid until you reboot the system, use the ndd utility . Using ndd is a good way to[...]

Appendix B Configuring the Quad F astEthernet Device Driv er Par ameters 31 ▼ T o Specify the Device Instance for the ndd Utility 1. Check the /etc/path_to_inst f ile to identify the instance associated with a particular device. In the example above, the four SUNW,qfe@ x ,1 instances are from a Sun Quad FastEthernet PCI adapter installed in slot [...]

32 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 Using the ndd Utility in Non-Interactive Mode This section describes how to modify and to display parameter values. ● T o modify a parameter value, use the -set option. If you invoke the ndd utility with the -set option, the utility passes value , which must be [...]

Appendix B Configuring the Quad F astEthernet Device Driv er Par ameters 33 ● T o list all the parameters supported by the qfe driver , type ndd /dev/qfe ? . (See T ABLE B-1 through T ABLE B-8 for parameter descriptions.) FIGURE B-1 Example of Listing All Parameters Supported by the qfe Driver # ndd /dev/qfe ? ? (read only) transceiver_inuse (r[...]

34 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 Setting Forced Mode This section describes how to set forced mode (not capable of auto-negotiation). ▼ T o Select One Local T ransceiver Capability and Setting Forced Mode 1. Select one of the following capabilities: adv_100fdx_cap , adv_100hdx_cap , adv_10fdx_c[...]

Appendix B Configuring the Quad F astEthernet Device Driv er Par ameters 35 Setting Parameters in the /etc/system File T o configure the qfe driver parameters for all SUNW,qfe devices in the system so that the parameter variables are always ef fective (even after rebooting the system), enter the parameter variables in the /etc/system file. When you[...]

36 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 Here’s an example of setting parameters in a /etc/system file: ▼ Setting the ipg1 and ipg2 Parameters in the /etc/system File 1. Become superuser . 2. Add the following lines to the /etc/system f ile: 3. Save the /etc/system f ile. 4. Save all f iles and exit [...]

Appendix B Configuring the Quad F astEthernet Device Driv er Par ameters 37 Setting ipg Driver Parameters Using a qfe.conf File 1. Obtain the hardware path names for the qfe devices in the device tree. T ypically the path names and the associated instance numbers will be present in the /etc/path_to_inst file. ■ In the above lines: ■ The first p[...]

38 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 In the third line in the pr evious 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 ipg1 and ipg2 p[...]

39 APPENDIX D Running Diagnostics T ests This appendix describes how to test the Sun Quad FastEthernet PCI adapter with its FCode PROM selftest . Note – T o test the Sun Quad FastEthernet PCI adapter further , refer to the SunVTS User ’ s Guide that shipped with your operating system. Using the OpenBoot PROM FCode Selftest The following tests a[...]

40 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 ▼ Running the Ethernet FCode Selftest Diagnostic T o 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 r eset the system, the diagnostic tests may cause the system to hang. For mor[...]

Appendix D Running Diagnostics T ests 41 6. T ype the following to run the selftest using the test command on one of the adapters four Ethernet channels: The following tests are run when the test command is executed: ■ hme register ■ MAC internal loopback ■ External loopback ■ 100 Mbps PHY loopback ■ 10 Mbps PHY loopback If the test passe[...]

42 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 8. Set the auto-boot? conf iguration parameter to true. 9. Reset and reboot the system. ok setenv auto-boot? true ok reset-all[...]

Index 43 Index A auto-negotiation, 17, 29, 34 B booting from network, 14 reconf iguration, 9 C configuring qfe driver parameters, 23 D declaration of conformity, v driver parameters, 24 driver_aliases file, 5 E editing /etc/hosts file, 1 1 /etc/system file, 15, 35 driver_aliases file, 5 hostname.qfe # files, 1 1 qfe.conf file, 15, 36 /etc/hosts fil[...]

44 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997 I increasing TCP/IP performance, 15 installing adapter into system, 6 driver software fr om the CD-ROM, 1 1 hardwar e, 6 instance numbers, finding, 12, 37 interface signals, 21 internal transceiver, 23, 28 inter-packet gap driver parameters, 25, 26, 36, 37 IPG par[...]

Index 45 requir ements hardwar e, 3 OpenBoot PROM, 3 software, 3 RJ-45 connectors, 21, 23 S selftest diagnostics, 39 setting qfe driver parameters, 30 show-devs output, 7, 14, 16, 40 software adding an additional delay, 26 auto-negotiation, 17 configuring driver parameters, 15, 23 to 38 host files, 1 1 qfe driver parameters, 30 editing driver_alias[...]

46 Sun Quad F astEthernet PCI Adapter Installation and User’s Guide • August 1997[...]

Ordering Sun Documents SunDocs SM is a distribution program for technical documentation and is available from SunExpress. To order or for more information: Sun W elcomes Y our Comments We are interested in improving our documentation and welcome your comments. Use the reader comment card or send comments via email to: smcc-docs@sun.com . You can al[...]

INFORMATION PRODUCTS M/S MPK14-108 SUN MICROSYSTEMS INC 2550 GARCIA AVE MOUNTAIN VIEW CA 94043-9551 UNITED STATES OF AMERICA AIR MAIL PAR AVION NO POSTAGE NECESSARY IF MAILED TO THE UNITED STATES NE PAS AFFRANCHIR INTERNATIONAL BUSINESS REPLY MAIL/RESPONSE PAYEE PERMIT NO. 808 MOUNTAIN VIEW CA IBRS/CCRI No. 808 POSTAGE WILL BE PAID BY ADDRESSEE[...]