Dual gigabit ethernet and dual scsi/p adapter (96 pages)
Summary of Contents for Sun Microsystems SunFastEthernet Adapte
Page 1
SunFastEthernet Adapter User Guide Sun Microsystems Computer Corporation 2550 Garcia Avenue Mountain View, CA 94043 U.S.A. Part No.: 801-6109-11 Revision A, November 1994...
Page 2
All SPARC trademarks, including the SCD Compliant Logo, are trademarks or registered trademarks of SPARC International, Inc. SPARCstation, SPARCserver, SPARCengine, SPARCstorage, SPARCware, SPARCcenter, SPARCclassic, SPARCcluster, SPARCdesign, SPARC811, SPARCprinter, UltraSPARC, microSPARC, SPARCworks, and SPARCompiler are licensed exclusively to Sun Microsystems, Inc. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. ®...
Preface This manual provides information about the SunFastEthernet Adapter card. Document Organization The information in this manual is presented in six chapters and four appendixes. Manual arrangement is as follows: Chapter 1: “Introducing the SunFastEthernet Adapter Card” describes the features of the SunFastEthernet Adapter card and provides hardware requirements.
Page 12
When You Need Help with UNIX Commands Appendix A: “Interface Signals” provides pinout data. Appendix B: “SunFastEthernet Adapter Card Specifications” provides information on performance and power specifications, physical dimensions, and environmental specifications. Appendix C: “Running Diagnostics” explains how to run diagnostic tests that verify the SunFastEthernet Adapter card is working correctly in the system.
Page 13
What Typographic Changes and Symbols Mean Section Table P-1, “Typographic Conventions describes the typefaces and symbols used in this book. Table P-1 Typographic Conventions Typeface or Symbol Meaning The names of commands, files, AaBbCc123 and directories; on-screen computer output What you type, contrasted with AaBbCc123 on-screen computer output AaBbCc123...
Notes, Cautions, and Warnings Warning – This equipment contains lethal voltage. Accidental contact can result in serious injury or death. Caution – Improper handling by unqualified personnel can cause serious damage to this equipment. Unqualified personnel who tamper with this equipment may be held liable for any resultant damage to the equipment.
Introducing the SunFastEthernet Adapter Card The information contained in this guide is organized as follows: Table 1-1 Organization Chapter/Appendi Material covered Introduction to SunFastEthernet Installing SunFastEthernet SBus card Solaris 1.x software installation Solaris 2.x software installation Network Linkups/Speed Selection Interface Signals SunFastEthernet Adapter Card Specifications Running Diagnostics Solaris 2.x Driver Performance Tuning...
Page 16
The SunFastEthernet™ Adapter card is a dual mode high speed ethernet SBus card that can operate at either 10 or 100Mbps. The card provides the Media Access Control (MAC) function for either a 10 or 100Mbps CSMA/CD protocol based network interface conforming to IEEE 802.3 and the Ethernet specification.
Page 18
Buffer memory XCVR management register Figure 1-2 SunFastEthernet Adapter User Guide—November 1994 SBus QEC ASIC Local bus EPROM BigMAC ASIC buffer buffer MII Interface Ultra DB40 External transceiver SunFastEthernet Block Diagram BabyBAC Transceiver RJ45...
Page 19
The SunFastEthernet Adapter card is supported on most SBus based Sun-4c, Sun-4m, and Sun-4d system architectures that run under the Solaris® environment or other compatible operating systems. To utilize the SunFastEthernet Adapter card, the system also needs to contain OpenBoot™ PROM (OBP) level 2.3 or later. Verify your OBP version by typing the banner command at the ok prompt.
Page 20
SunFastEthernet Adapter User Guide—November 1994...
Installing the SunFastEthernet SBus Card 2.1 Card Installation 1. Remove the SunFastEthernet Adapter card from the antistatic bag and Figure 2-1 2. Place the card, component side up, on the bag. 3. Install the card according to the SBus installation procedures in the Note –...
5. Verify SunFastEthernet installation by testing the card as indicated in the 2.2 Testing the SunFastEthernet Adapter Card Before Booting the System Note – To utilize the SunFastEthernet Adapter card, the system needs to contain OpenBoot™ PROM (OBP) level 2.3 or later. After the SunFastEthernet Adapter card is installed, and before booting the system, verify installation by performing the following procedure: 1.
Page 23
2. Use show-devs to find out SBus card information. The show-devs command used by itself shows the entire device tree. The example below shows information for a SPARCserver™ 1000 system with only one system board (board 0) and a SunFastEthernet channel installed in slot 1.
Page 24
Note – To find out the OpenBoot PROM revision level on your system, type .version Note – Activity may also be displayed for the le0 interface if it is connected. SunFastEthernet Adapter User Guide—November 1994 at the prompt. <#0> ok a.
Page 25
b. If the system has OpenBoot PROM 2.3 to 2.5, use the watch-net command. <#0> ok watch-net Qe register test -- succeeded. Internal loopback test -- succeeded. Transceiver check -- 100 mbps Link Down, 10 mbps Link Up, passed. Tx/Rx enable/disable test--succeeded Frame counter test--succeeded Address detection test--succeeded Address hash test--succeeded...
2.3 Booting From SunFastEthernet Devices To get information about valid SunFastEthernet device path names for your machine use the show-devs command as shown in the following example: Look for the be node in the device paths. For the preceding example, the device boot path for the SunFastEthernet channel would be: /io-unit@f,e0200000/sbi@0,0/qec@1,20000/be@0,0 Note –...
2.4 Relocating a SunFastEthernet Card (Solaris 2.x Only) If a SunFastEthernet card is installed in an sbus slot and you later change the location of the card, then you must perform the following procedure or the driver will not be recognized within the system: 1.
Page 28
SunFastEthernet Adapter User Guide—November 1994...
Installing SunFastEthernet Software Using Solaris 1.x The Solaris 1 software version of the SunFastEthernet driver is supported on Solaris 1.1 (SunOS 4.1.3) and later releases. To utilize the SunFastEthernet Adapter card, the system also needs to contain OpenBoot™ PROM (OBP) level 2.3 or later.
3.1 Hardware Requirements Table 3-1 lists systems supported under the Solaris 1.x software versions for Sun -4m architectures: Note – The SunFastEthernet is not supported on the SBus Expansion Subsystem under Solaris 1.x. Table 3-1 Platform Architecture Sun-4m 3.2 Preparing for Software Installation Before loading the SunFastEthernet software: •...
• To confirm the existence of the link in the /export/exec directory, use the commands shown in the following example: hostname # cd /export/exec hostname # ls -l sun4 lrwxrwxrwx l root 4 Apr 9 03:27 sun4 -> /usr The example response from command ls -l shows that the sun4 and /usr directories are symbolically linked.
3.3.3 Mounting the CD-ROM 1. Mount the CD-ROM from either a local or remote machine. For example, 2. After successfully mounting the CD-ROM filesystem, change directories 3.3.4 Install Script Using cdm 3. Enter ./cdm at a shell prompt. You will then see the following display: SunFastEthernet Adapter User Guide—November 1994 for a local machine enter the following: hostname # mkdir /cdrom...
Page 33
4. Enter 1 to select an application. You will then see the following display: Applications available: 1. SBus Quad Ethernet Controller Driver 2. SunFastEthernet Driver Please enter a number or q to quit: 5. Enter 2 to select SunFastEthernet. You will then see the following display: * “SunFastEthernet”...
Page 34
SunFastEthernet Adapter User Guide—November 1994...
Page 35
DFARS 52.227-7013 (Oct. 1988) and FAR 52.227-19(c) The OPEN LOOK(R) and Sun(R) Graphical User Interfaces were developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox(R) in researching and developing the concept of visual or graphical user interfaces for the computer industry.
Page 36
SunFastEthernet Adapter User Guide—November 1994 The X Window System is a product of the Massachusetts Institute of Technology. Sun, Sun Microsystems, the Sun Logo, Solaris, SunOS, ONC, NFS, OpenWindows, DeskSet, AnswerBook, SunLink, SunView, SunDiag, NeWS, OpenBoot, OpenFonts, SunInstall, SunNet, ToolTalk, X11/NeWS and XView are trademarks or registered trademarks of Sun Microsystems, Inc.
Page 37
9. The script will then query: Do you want to see a description of this installation script [y|n]? Follow by entering n. You will then see the following display: Install the SunFastEthernet driver. Installation should take approximately 2 minutes. Here is the Current Free Disk space: Filesystem kbytes /dev/sd1a...
Page 38
Note – The install script assumes you have assigned the hostname for the SunFastEthernet. For example, if you want to call the SunFastEthernet system5, then system5 should exist in the /etc/hosts file or NIS hosts maps (if you are running NIS), otherwise the script exits, and you will have to restart cdm again.
Page 39
you for a hostname for every SunFastEthernet hardware device installed. Once all devices have been given a hostname, you will then see the following display: The current official hostname is: (current official hostname) Do you wish to change the official hostname? (y|n) [n]: 12.
Page 40
You will then see the following prompt: New System Config File [BQE]: 3-12 SunFastEthernet Adapter User Guide—November 1994...
Page 41
If you want to change the new system config file from the default [BQE], then enter the new file name now or press RETURN to accept the default. You will then see the following display: File protection on files and BQE adjusted ... Doing a “make depend”...
Page 42
Note – If there are problems with the preceding procedure (moving vmunix / rebooting), then you need to boot the old vmunix which is vmunix.org in the above example. Thus, type: boot vmunix.org. The install script will then return you to cdm and the following display 3-14 SunFastEthernet Adapter User Guide—November 1994 Followed by:...
3.3.5 SunFastEthernet Directories The following table lists the major subdirectories of the directory that receives SunFastEthernet files, /export/exec/sun4/BQE. Note that /export/exec/sun4 is a symbolic link to /usr. Table 3-2 Subdirectory 4.1.3/sys 4.1.3_u1/sys install usr/bin usr/man 3.3.6 Installation Verification Note – The SunFastEthernet interface will not function in a network that uses network trailers.
You can also use ifconfig to check on a particular interface, for example: The string <UP,BROADCAST,NOTRAILERS,RUNNING> indicates that the SunFastEthernet interface is correctly installed and configured. 3.4 Setting Up Diskless Clients This section tells you how to set up a server so that you can boot and run diskless client workstations over the SunFastEthernet.
Page 45
If you are on a SunOS 4.1.3 machine use 4.1.3 in place of OSVER, for releases later than SunOS 4.1.3 use 4.1.3_U1 in place of OSVER. Enter the following commands: # cp /usr/BQE/OSVER/sys/sunif/* SYS/sunif # cp /usr/BQE/OSVER/sys/sun4m/OBJ/* SYS/sun4m/OBJ # cp SYS/sun4m/conf/files SYS/sun4m/conf/files.prebqe Add the following lines to SYS/sun4m/conf/files: SunFastEthernet and SBus Quad Ethernet Controller sunif/if_qec.c...
Page 46
3-18 SunFastEthernet Adapter User Guide—November 1994...
Installing SunFastEthernet Software Using Solaris 2.x This chapter describes SunFastEthernet installation requirements for Solaris 2.x software versions only. The SunFastEthernet Adapter card is supported on most SBus based Sun-4c, Sun-4m, and Sun-4d system architectures that run under the Solaris® environment — or other compatible operating systems. To utilize the SunFastEthernet Adapter card, the system also needs to contain OpenBoot™...
Table 4-1 Platform Architecture Sun-4c Sun-4d Sun-4m 4.2 Solaris 2.3 Hardware: 5/94 Software Requirements Solaris 2.3 Hardware: 5/94 is the first Solaris 2 release supporting the SunFastEthernet. The driver for the SunFastEthernet is installed from the package SUNWbmac. You will find this package on the Solaris 2.3 Hardware: 5/94 CD.
automatically installs SUNWbmac. If disk space is a concern, and you choose to install another cluster, use the pkgadd command to add the SunFastEthernet driver as described in the following procedure: Table 4-2 Solaris 2.3 Hardware: 5/94 CD Cluster Entire Distribution plus OEM Support Entire Distribution End User System Support Core System Support...
4. Verify that the driver is installed as follows: 5. Once you verify that the driver has been installed, proceed to the 4.2.4 Host File Configuration Complete the host file configuration before you install the SunFastEthernet Adapter card. By creating and configuring the system files before installing the card, you will have to reboot your system only once.
2. Create an appropriate entry in the /etc/hosts file for each active be channel. Using the example in step 1, you will have: zardoz# cat /etc/hosts # Internet host table 127.0.0.1 129.144.10.57 129.144.11.83 129.144.12.41 Once /etc/hostname.be<num> files and /etc/hosts files are created/updated: 3.
Table 4-3 Cluster Entire Distribution plus OEM Support Entire Distribution Programmer End User System Support Core System Support If SunFastEthernet hardware was not installed when the Solaris 2.3 Hardware: 8/94 software distribution was installed using one of the last four clusters, then the driver is not automatically installed via suninstall, instead, the driver must be installed using the pkgadd command.
3. Use the cd command and go to the directory containing your particular architecture. 4. Type the following line to get a listing for the minor device number for the be0 device: # ls -l devices/pseudo/clone@0:be The resultant listing will have the following format: crw-rw-rw 1 root sys 11,<minor-device number>...
3. Copy be driver to clients root partition as follows: 4.4 Solaris 2.4 Hardware: 11/94 Software Requirements Note – The patch described in the following paragraph is mandatory for Solaris 2.4. You can find the Solaris 2.4 software for the SunFastEthernet adapter card on the Solaris 2.4 Hardware: 11/94 Software CD.
Network Linkups/Speed Selection The information presented in this chapter is applicable to both Solaris 1.x and 2.x software versions. 5.1 Network Link Ups 5.1.1 10/100Mbps Link Up Using RJ45 Connector If your SunFastEthernet channel is connected to a 10 or 100Mbps network through the RJ45 connector you will receive a Link Up message whenever you boot the system or disconnect and then reconnect to the network.
Note – If you do not see a “10 or 100Mbits/sec Link Up” message, then the link is down and the probable cause could be a disconnected cable, transceiver or hub. 5.1.2 10/100Mbps Link Up Using MII interface Connector If your SunFastEthernet channel is connected to a 10 or 100 Mbps network through the MII interface connector you will receive a Link Up message whenever you boot the system or disconnect and then reconnect to the network.
5.2 Speed Selection If you receive the following messages after connecting to a 10 or 100Mbps network then more than likely the external hub and the SunFastEthernet are out of sync. In these instances speed selection may be done manually using the be_speed utility as indicated in the procedure that follows: # be<num>: 100 Mbps Link Up This utility is available in the directory /usr/sbin only if patch ID 101820-01 is...
Page 58
SunFastEthernet Adapter User Guide—November 1994...
Interface Signals Table A-1 lists SBus interface signals and their corresponding pin numbers. Table A-1 SBus Interface Signals Pin No. Description Pin No. SEL* INT (1)* D (0) D (2) D (4) INT (2)* D (6) D (8) D (10) INT (3)* D (12) D (14)
Page 60
Table A-1 Pin No. SunFastEthernet Adapter User Guide—November 1994 SBus Interface Signals (Continued) Description Pin No. Description PA (26) D (17) -12V D (18) D (20) D (22) D (24) D (1) D (26) D (3) DA (28) D (5) D (30) D (7) SIZ (1)
SunFastEthernet Adapter Card Specifications B.1 Performance Specifications Table B-1 Performance Specifications SBus Clock Max SBus Burst Transfer Rate Max Ethernet Transfer Rate SBus Data/Address Lines SBus Modes Capacitance per SBus Signal Line SBus Parity SBus Version SBus Burst Sizes Feature Specification 12.5MHz to 25MHz 12.5Mbytes/sec...
B.2 Power Specifications Table B-2 Power Specifications Power Dissipation Voltage Tolerance Ripple Operational Current B.3 Physical Dimensions Table B-3 Overall Physical Dimensions SunFastEthernet Adapter User Guide—November 1994 Specification Dimension Measurement Length 5.78 in. (147.70 mm) Width 3.3 in. (83.82 mm) Weight 5.52 oz.
Running Diagnostics Note – The SunFast Ethernet Adapter is not supported in Sundiag for Solaris 1.x. The tests available for this device consist of a selftest and SunDiag. C.1 Selftest The SunFastEthernet selftest is a test that verifies correct operation of the SBus card.
Page 68
To check that the system has a SunFastEthernet Adapt;er card installed and in which SBus slot, look for the be device in the following command: To display the OBP set of environment variables, type the following command: To change an OBP environment variable, for example auto-boot? to false, use the setenv command as follows, then type reset for the change to take effect: SunFastEthernet Adapter User Guide—November 1994 SPARCstation 2, Type 4 keyboard...
Page 69
ok setenv auto-boot? false ok reset To browse the OBP device tree, use the cd command to get to a specific working directory, and words to find all the Forth words available in that directory: ok cd /sbus/qec@1,20000/be ok words read write load...
C.1.1 Selftest Description The Selftest can be invoked from the ok prompt on a Sun machine that has OBP 2.x or later as follows: 1. Set the diag-switch to true. At the Note – If the diag switch is not set to true reduced tests are run. 2.
Page 71
C.1.1.1 Register Test This test performs write, read, and compare on the QEC, bmac, and transceiver registers. The test will then issue a reset to make sure that the appropriate register contents are reset. C.1.1.2 Internal Loopback Test This test will check the internal loopback data path. C.1.1.3 Transceiver Test This test will check the onboard transceiver connection and the link status.
C.1.2 Debug using Selftest For debuging under selftest refer to “Writing FCode Programs, Revision A, November 1993” (Sun Part Number 801-5123-10). C.2 Sundiag Sundiag is an on-line system exerciser that runs diagnostic hardware tests. It is used primarily with the OpenWindows software interface that enables you to quickly and easily set test parameters to run tests.
C.2.2 The Sundiag Window Note – The SunFast Ethernet Adapter is not supported in Sundiag for Solaris 1.x. Note – Examples in this section show Sundiag running in the OPEN LOOK® environment. Sundiag run in the SunView™ environment will look different. To start Sundiag, cd to the Sundiag directory (/opt/SUNWdiag/bin/sundiag) and then type the sundiag command.
Figure C-1 C.2.3 Starting the Test 1. Review the information in the control panel, which identifies the devices 2. Click on the Start button. 3. Watch the console window for messages. SunFastEthernet Adapter User Guide—November 1994 Sundiag Window that are available for testing. Click on the device that you want to test, in this case (USER 0) nettest.Your selection is confirmed with the display of a highlighted box next to the device name...
Page 75
4. To interrupt a test or to stop after a test is completed, click on the Stop button. If no problems are identified during the testing, the SunFastEthernet card is ready for operation in your system. Click on the Quit button to exit Sundiag. Running Diagnostics...
Page 76
C-10 SunFastEthernet Adapter User Guide—November 1994...
Solaris 2.x Driver Performance Tuning If your system is a server which serves clients with heavy traffic and you experience numerous RPC errors, you may fine tune your system for performance by changing the buffer default settings in the /etc/system file as follows.
Page 78
SunFastEthernet Adapter User Guide—November 1994...
Console Messages (Solaris 1.x Only) The SunFastEthernet software can output the messages listed below. Each message is accompanied by an explanation and/or workaround. Some of the messages indicate normal operation of the product, while others indicate an error condition. In the latter category, certain messages indicate a transitory condition, while others indicate a condition fatal to the operation of the SunFastEthernet device.
Page 80
The no carrier portion of this message indicates that the device may have lost the carrier detect signal. The driver has a test feature that verifies the Ethernet cable connection between the device and the Ethernet hub. In order for this feature to function correctly, the Ethernet hub must support the link test feature and it must be turned on in the hub.
be<num>: SBus tx derror ack The DMA engine encounted an error which indicates a potential hardware or driver problem. be<num>: SBus rx late error be<num>: SBus tx late error be<num>: SBus rx parity error be<num>: SBus tx parity error The DMA engine encounted an error which typically indicates a hardware problem.
Page 82
The driver cannot allocate sufficient memory for resources. These messages occur when attempting to load the driver. You will be unable to load the driver until sufficient memory becomes free. Terminating unnecessary processes or unloading unused drivers are ways to free memory. The values for the berpending and qerpending combined are too large.
Page 83
error is usually symptomatic of trouble elsewhere in the operating system. be<num>: map_regs for qec per-channel reg failed be<num>: map_regs for bmac reg failed be<num>: map_regs for bmac transceiver reg failed be<num>: mb_nmapalloc for QMD and buffers failed The driver cannot allocate sufficient address space for resources. These messages occur when attempting to load the driver.
Page 84
The driver has received a packet with an incorrect checksum field. Indicates that the device receive FIFO has overflowed. This is most likely due to the system being under a heavy load. The driver has received a packet containing a noninteger multiple of eight bits and there was a CRC error.
Page 85
transmission of a chained packet. This indicates a problem in the driver. The device will reset itself and continue normal operation. be<num>: tx babble A packet larger than 1518 bytes was passed to the device. This indicates an error in the driver. be<num>: tx fifo underflow Indicates that the device transmit FIFO has underflowed.
Page 86
device. The SBus card has reported an invalid number of device registers. The device may be bad, or there may be a problem in the operating system or driver. The driver doesn’t have a parent driver. This error is usually symptomatic of trouble elsewhere in the operating system.
Need help?
Do you have a question about the SunFastEthernet Adapte and is the answer not in the manual?
Questions and answers