Sun Quad FastEthernet PCI Adapter Installation and User’s Guide A Sun Microsystems, Inc.
USA 650 960-1300 fax 650 969-9131
Sun Quad FastEthernet PCI Adapter Installation and User’s Guide Part No: 805-1797-10 Revision A, August 1997
Copyright 1997 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California 94303-4900 U.S.A. All rights reserved. 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.
Contents Preface 1. viii Product Overview Features 1 2 Hardware and Software Requirements 2 Checking the OpenBoot PROM Revision Level 3 H 2. Displaying the OpenBoot PROM Revision Level 3 Installing the Adapter 5 Adding an Entry to the driver_aliases File 5 Installing the Adapter 6 Verifying the Installation 7 Diagnostic Testing 7 Examining Network Activity Rebooting the System 3.
Increasing TCP/IP Performance 14 Forcing Network Speed Between 10 Mbps and 100 Mbps 15 Auto-Negotiation 16 local-mac-address Property A. 16 Specifications 19 Physical Dimensions 19 Power Requirements 20 Performance Specifications 20 B. Interface Signals 23 C.
H E.
vii Sun Quad FastEthernet PCI Adapter Installation and User’s Guide ♦ Revision A, August 1997
Preface The Sun Quad FastEthernet PCI Adapter Installation andTM User’s Guide provides TM 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,” describes the hardware and software features for the Sun Quad FastEthernet PCI adapter.
Related Documents The following documents contain topics that relate to the information in the Sun Quad FastEthernet PCI Adapter Installation and User’s Guide. Title Part Number Your system installation or service manual (System dependent) Solaris 2.x Handbook for SMCC Peripherals (Release dependent) SunVTS User’s Guide (Release dependent) Sun Quad FastEthernet 2.0 CD-Insert 804-5901 OpenBoot 3.
Typographic Conventions The following table describes the typographic changes used in this book. Typeface or Symbol AaBbCc123 Meaning Example The names of commands, files, and directories; on-screen computer output Edit your.login file. Use ls -a to list all files. You have mail. AaBbCc123 What you type, contrasted with on-screen computer output machine_name% su Password: AaBbCc123 Command-line placeholder: To delete a file, type rm filename.
Shell Prompt Bourne shell and Korn shell $ Bourne shell and Korn shell superuser # 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 (continued) 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. 4 Email: smcc-docs@sun.
xiii Sun Quad FastEthernet PCI Adapter Installation and User’s Guide ♦ Revision A, 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.
Features This PCI adapter offers the following features: 4 Fully complies with the ANSI/IEEE std. 802.3 CSMA/CD physical layer specification 4 Four Switchable 10BASE-T/100BASE-TX Ethernet channels with auto negotiation. Conforms to IEEE 802.3u Ethernet standard 4 Provides operations of up to 100 meters of twisted-pair without use of repeaters 4 Four independent Ethernet channels run at either 10 Mbps or 100 Mbps 4 Supports half-duplex or full-duplex operation modes 4 Multiple 48-bit IEEE 802.
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 1. At the ok prompt, type .version to check your system’s OpenBoot PROM revision level. ok .version Release 3.
4 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide ♦ Revision A, 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_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.
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.
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 ok prompt. 2. Use the show-devs command to list the system devices.
1. Examine network activity and incoming network packets by typing watch-net-all at the ok prompt. The watch-net-all command monitors network traffic on all network interfaces in the system. In the example below, the watch-net-all command tests all four of the adapter’s interfaces, two of which are connected to a network. CODE EXAMPLE 2–1 watch-net-all Commad Output ok watch-net-all /pci@1f,2000/pci@2/SUNW,qfe@0,1 Internal loopback test -- succeeded.
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. 1. Perform a reconfiguration boot on the system. ok boot -r Refer to the Solaris 2.x Peripheral’s Handbook for more information.
10 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide ♦ Revision A, 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.
"/pci@1f,2000/pci@2/SUNW,qfe@3,1" 7 "qfe" 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 bold. 2. Create an /etc/hostname.qfe file, where corresponds to the instance number of each interface you plan to use.
3. Create an appropriate entry in the /etc/hosts file for each active qfe channel. Using the example in Step 1 on page 11, 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. Booting From the Network To use a Sun Quad FastEthernet PCI adapter ethernet interface as the boot device, perform the following tasks: 1.
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 qfe device 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 16.
Forcing Network Speed Between 10 Mbps and 100 Mbps 1. At the ok prompt, use the show-devs command to list the system devices. You should see the full path names of the qfe devices, 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.
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 mac-address property 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 ♦ Revision A, August 1997
APPENDIX A Specifications Physical Dimensions TABLE A–1 Physical Dimensions Assembly Dimension Measurement Length 7.395 in (186.06 mm) Width 4.759 in (120.88 mm) Height: Primary component side 0.570 in. (14.48 mm) Back side 0.105 in. (2.67 mm) Weight 5.
Power Requirements TABLE A–2 Power Requirements Specification Measurement Maximum Power Dissipation 14 Watts Maximum Power Consumption 2.8 Amps @ 5V Voltage Tolerance 5V +/- 5% Ripple Maximum 100 mV Operational Current 5V, 2.0 Amps Performance Specifications TABLE A–3 Performance Specifications Specification Performance Maximum Ethernet Transfer Rate 10/100 Mbps per channel Host Interface 256-pin PBGA PCI to PCI bridge with a 64-bit primary and 32-bit secondary interface.
TABLE A–3 Performance Specifications (continued) Ethernet Version Conforms to IEEE 802.3u PCI clock 33 MHz max. PCI data burst transfer rate 133 MB/sec.
22 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide ♦ Revision A, August 1997
APPENDIX B Interface Signals Figure B–1 TABLE B–1 32-Pin RJ-45 Connectors Pin Descriptions for the 32-Pin RJ-45 Connectors: Channels 0 - 3 Description CH0 CH1 CH2 CH3 TD+ 1 9 17 25 TD– 2 10 18 26 RD+ 3 11 19 27 Not Used 4 12 20 28 Not Used 5 13 21 29 RD– 6 14 22 30 Not Used 7 15 23 31 Not Used 8 16 24 32 23
TABLE B–1 24 Pin Descriptions for the 32-Pin RJ-45 Connectors: Channels 0 - 3 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide ♦ Revision A, August 1997 (continued)
APPENDIX C Configuring the Quad FastEthernet Device Driver Parameters The qfe device driver controls the Sun Quad FastEthernet PCI adapter’s SUNW,qfe Ethernet devices. You 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 used in the adapter, lists the available qfe device driver parameters, and describes how you can configure these parameters.
Driver Parameter Values and Definitions This section describes the parameters and settings for the qfe device driver. Table C–1 lists these parameters.
TABLE C–1 qfe Driver Parameter, Status, and Descriptions (continued) Parameter Status Description 100hdx_cap Read only Local transceiver capability of the hardware 10fdx_cap Read only Local transceiver capability of the hardware 10hdx_cap Read only Local transceiver capability of the hardware lp_autoneg_cap Read only Link partner auto negotiation capability lp_100fdx_cap Read only Link partner capability lp_100hdx_cap Read only Link partner capability lp_10fdx_cap Read only Link pa
TABLE C–2 Read-Only Parameters Defining the Current Status Parameter Values link_status 0 Description Current link status = Link down 1 = Link up link_speed Valid only if the link is up 0 = 10 Mbps 1 = 100 Mbps link_mode Valid only if the link is up 0 = Half duplex 1 = Full duplex Inter-Packet Gap Parameters The PCI Fast Ethernet and Expansion (PFEX) ASIC supports the programmable Inter-Packet Gap (IPG) parameters ipg1 and ipg2. The total IPG is the sum of ipg1 and ipg2.
If your network has systems that use longer IPG (the sum of ipg1 and ipg2) and if those machines seem to be slow in accessing the network, increase the values of ipg1 and ipg2 to match the longer IPGs of other machines. Defining an Additional Delay Before Transmitting a Packet Using lance_mode and ipg0 The PCI Fast Ethernet and Expansion (PFEX) ASIC supports a programmable mode called lance_mode. The ipg0 parameter is associated with lance_mode.
Operational Mode Parameters Table C–5 describes the operational mode parameters and their default values. TABLE C–5 Operational Mode Parameters Parameter Values adv_autoneg_cap0 1 Description Local transceiver capability advertised by the hardware = Forced mode = Auto-negotiation (default) adv_100fdx_cap1 0 1 Local transceiver capability advertised by the hardware; read/write parameter = Not 100Mbit/sec full-duplex capable (default in the Solaris 2.5 and 2.5.
Defining the Number of Back-to-Back Packets to Transmit The pace_size parameter (see Table C–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 C–7 Read-Only Transceiver Capabilities (continued) Parameter Description Values 10fdx_cap Local transceiver capability of the hardware; initialized at startup 0 = Not 10Mbit/sec full-duplex capable 1 = 10Mbit/sec full-duplex capable 10hdx_cap Local transceiver capability of the hardware; initialized at startup 0 = Not 10Mbit/sec half-duplex capable 1 = 10Mbit/sec half-duplex capable Reporting the Link Partner Capabilities Table C–8 describes the read-only link partner capabilities.
If the link partner is capable of auto-negotiation (when lp_autoneg_cap is 1) then the speed and mode information is displayed when you use auto-negotiation and get the link partner capabilities. Setting qfe Driver Parameters You can set the qfe device 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 ndd utility. Using ndd is a good way to test parameter settings.
"/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,1 instances 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.
Using the ndd Utility in Interactive Mode 1. To modify a parameter value in interactive mode, specify ndd /dev/qfe, as shown below. The ndd utility 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 ndd utility prompts you for the parameter value (see Table C–1 through Table C–8). 1. To list all the parameters supported by the qfe driver, type ndd /dev/qfe \?.
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 C–5). 2.
Setting Parameters in the /etc/system File To configure the qfe driver parameters for all SUNW,qfe devices in the system so that the parameter variables are always effective (even after rebooting the system), enter the parameter variables in the /etc/system file. When you reboot the system, the system reads the /etc/system file and sets these parameter variables in the qfe module in the operating system kernel. Table C–9 lists the variables you can set in the /etc/system file.
These parameter values, described in “Driver Parameter Values and Definitions” on page 26, are applicable to all SUNW,qfe devices on the system. See Table C–1 through Table C–8 for the descriptions of these parameters. Here’s an example of setting parameters in a /etc/system file: Setting the ipg1 and ipg2 Parameters in the /etc/system FileSetting the ipg1 and ipg2 Parameters in the /etc/system File 1. Become superuser. 2.
Setting ipg Driver Parameters Using a qfe.conf File 1. Obtain the hardware path names for the qfe devices in the device tree. Typically the path names and the associated instance numbers will be present in the /etc/path_to_inst file.
4 Name = SUNW,qfe 4 Parent = /pci@1f,2000/pci@2 4 Unit-address = 3,1 1. Set the ipg1 and ipg2 parameters for the above four devices in the /kernel/drv/qfe.conf file.
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 User’s 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.
Running the Ethernet FCode Selftest DiagnosticRunning 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.
The following tests are run when the test command is executed: 4 hme register 4 MAC internal loopback 4 External loopback 4 100 Mbps PHY loopback 4 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.
44 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide ♦ Revision A, August 1997
APPENDIX E Regulatory Compliance Statements Your Sun product is marked to indicate its compliance class: 4 Federal Communications Commission (FCC) — USA 4 Department of Communications (DOC) — Canada 4 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.
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.
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.
Declaration of Conformity Compliance ID: QFEPCI Product Name: SUN QFE PCI This product has been tested and complies with: EMC European Union — EC This equipment complies with the following requirements of the EMC Directive 89/ 336/EEC: EN55022 / CISPR22 (1985) EN50082-1 48 Class A IEC801-2 (1991) 4 kV (Direct), 8 kV (Air) IEC801-3 (1984) 3 V/m Sun Quad FastEthernet PCI Adapter Installation and User’s Guide ♦ Revision A, August 1997
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: 4 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 Quality Assurance Manager Sun Microsystems, Inc.
50 Sun Quad FastEthernet PCI Adapter Installation and User’s Guide ♦ Revision A, August 1997
Index Index-51