Sun Microsystems none manual

2550 Garcia A venue Mountain V iew , CA 94043 USA 415 960-1300 fax 415 969-9131 Sun Microsystems Computer Company Platform Notes: The hme Fast Ethernet  Device Driver Part No: 802-5333-10 Revision A, May 1996[...]

Please Recycle Copyright 1996 Sun Microsystems, Inc., 2550 Gar cia A venue, Mountain V iew , California 94043-1 100 U.S.A. All rights reserved. This product or document is pr otected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be r eproduced in an[...]

Copyright 1996 Sun Microsystems Inc., 2550 Gar cia A venue, Mountain V iew , Californie 94043-1 100, U.S.A.T ous droits réservés. Ce produit ou document est pr otégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie, la distribution, et la décompilation. Aucune partie de ce produit ou de sa document[...]

[...]

v Contents 1. Introduction to the hme Fast Ethernet Device Driver . . . . . . . 1 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 T ypographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Ordering Sun Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.[...]

vi Platform Notes: The hme Fast Ethernet Device Driver — May 1996 Operational Mode Parameters . . . . . . . . . . . . . . . . . . . . . . . . 13 Defining the Number of Back-to-Back Packets T o T ransmit 15 Reporting T ransceiver Capabilities . . . . . . . . . . . . . . . . . . . . 15 Reporting the Link Partner Capabilities . . . . . . . . . . . [...]

Contents vii Setting Parameters in the /etc/system File . . . . . . . . . . . . . . 25 ▼ T o set the ipg1 to 10 and ipg2 to 5 when you reboot . 26 Setting Parameters Using the hme.conf File. . . . . . . . . . . . . . . 27 ▼ T o set ipg1 to 20 and ipg2 to 10 for the SUNW,hme device in SBus slot 0xe . . . . . . . . . . . . . . . . . . . . . . . .[...]

viii Platform Notes: The hme Fast Ethernet Device Driver — May 1996[...]

1 Intr oduction to the hme Fast Ethernet Device Driver 1 This book describes how to configure the hme driver for the Sun  Ultra  1 Series systems, the Sun Ultra 2 Series system, the Ultra  Enterprise  3000, 4000, 5000, and 6000 systems, the SunSwift  SBus Adapter , and the SunFastEthernet  Adapter 2.0. T o configure the hme driv[...]

2 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 1 • Solaris Reference Manual for SMCC-Specific Softwar e : Explains the following man pages: • ndd (1M) man page summarizes information on how to use the ndd utility • prtconf (1M), system (4), and driver.conf (4) man pages describe information about entering parameter values[...]

Introduction to the hme Fast Ethernet Device Driver 3 1 Shell Pr ompts in Command Examples T able 1-2 shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell. Ordering Sun Documents The SunDocs Order Desk is a distribution center for Sun Micr osystems technical documentation. Y ou can use major credit card[...]

4 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 1 Sun W elcomes Y our Comments Please use the Reader Comment Card that accompanies this document. W e are interested in impr oving our documentation and welcome your comments and suggestions. If a card is not available, you can also email or fax your comments to us. Please include t[...]

5 The hme Device Driver 2 The hme device driver handles the SUNW,hme device on these hardware devices: • SunSwift SBus Adapter • SunFastEthernet Adapter 2.0 • Sun Ultra 1 Creator Series systems • Sun Ultra 2 Series system • Ultra Enterprise 3000, 4000, 5000, and 6000 systems This chapter gives a hardwar e overview of the SUNW,hme device, [...]

6 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 2 In addition to the RJ-45 connector , a Media Independent Interface (MII) connector , which is an Ultra DB 40 connector , is also provided on Sun systems. The MII connects to an external transceiver that may use any physical media, such as copper or fiber as specified in the 100B[...]

The hme Device Driver 7 2 • Selects the highest common denominator mode of operation based on the following priorities: • 100 BASE-T4 • 100 Mbps, full-duplex • 100 Mbps, half-duplex • 10 Mbps, full-duplex • 10 Mbps, half-duplex The link partner is the networking device (system, Ethernet hub, or Ethernet switch) at the other end of the l[...]

8 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 2 • If the external transceiver supports auto-negotiation, the driver uses the auto-negotiation feature to select the link speed and mode. • If the external transceiver does not support auto-negotiation, the driver selects the highest priority mode supported by the transceiver .[...]

9 Parameter Definitions 3 This chapter describes the parameters and settings for the hme device driver . Driver Parameter V alues and Definitions The following sections describe the hme driver parameters, which are listed in T able 3-1. T able 3-1 hme Driver Parameter , Status, and Descriptions Parameter Status Description transceiver_inuse Read [...]

10 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 3 adv_100hdx_cap Read and write Operational mode parameter adv_10fdx_cap Read and write Operational mode parameter adv_10hdx_cap Read and write Operational mode parameter autoneg_cap Read only Local transceiver auto negotiation capability 100T4_cap Read only Local transceiver capab[...]

Parameter Definitions 11 3 Defining the Current Status The read-only parameters described in T able 3-2 explain the operational mode of the interface. These parameters define the current status. Inter-Packet Gap Parameters The Fast Ethernet Parallel Port SCSI (FEPS) ASIC supports programmable Inter-Packet Gap (IPG) parameters ipg1 and ipg2 . The[...]

12 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 3 By default, the driver sets ipg1 to 8-byte time and ipg2 to 4-byte time, which are the standar d 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[...]

Parameter Definitions 13 3 T able 3-4 defines the lance_mode and ipg0 parameters. Operational Mode Parameters T able 3-5 describes the operational mode parameters and their default values. 1. The default value is 16 nibble-times, which is 6.4 microseconds for 10 Mbps and 0.64 microseconds for 100 Mbps. T able 3-4 Parameters Defining lance_mode a[...]

14 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 3 Selecting the Internal or External T ransceiver Use the use_int_xcvr parameter to change the default behavior . For example, you can select the internal transceiver , even though the driver is capable of selecting the external transceiver . The driver , not the hardwar e, makes t[...]

Parameter Definitions 15 3 Defining the Number of Back-to-Back Packets T o T ransmit The pace_size parameter (see T able 3-6) defines the maximum number of back-to-back packets you can transmit at one time. If the value is zero, ther e is no limit to the number of back-to-back packets that can be transmitted. Reporting T ransceiver Capabilities [...]

16 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 3 The parameters in T able 3-7 define the capabilities of the hardwar e. The internal transceiver can support all of these capabilities. The capabilities of the external transceiver are dependent on the device. If the external transceiver is not capable of auto-negotiation but has[...]

Parameter Definitions 17 3 If the link partner is not capable of auto-negotiation (when lp_autoneg_cap is 0) the information described in T able 3-8 is not relevant and the parameter value=0. If the link partner is capable of auto-negotation (when lp_autoneg_cap is 1) then the speed and mode information is displayed when you use auto-negotiation a[...]

18 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 3[...]

19 Setting Parameters 4 This chapter describes how to configure the hme driver parameters using the ndd utility in the /etc/system file, or in the hme.conf file. Use the ndd utility to configure parameters that ar e valid until you reboot the system. T o configure the hme driver parameters for all devices in the system so that the parameter va[...]

20 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 4 T o set parameters so they remain in effect after you r eboot the system: • Add the parameter values to /etc/system when you want to configure parameters for all devices in the system. • Create the hme.conf file and add parameter values to hme.conf when you need to set a pa[...]

Setting Parameters 21 4 2. Use that instance number to select the device as follows: The device remains selected until you change the selection. Non-Interactive and Interactive Modes Y ou can use the ndd utility in two modes: • Non-interactive • Interactive In non-interactive mode, you invoke the utility to execute a specific command. Once the[...]

22 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 4 ▼ T o display the value of a parameter ♦ Specify the parameter name (and omit the value). When you omit the -set option, a query operation is assumed and the utility queries the named driver instance, retrieves the value associated with the specified parameter , and prints i[...]

Setting Parameters 23 4 ▼ T o list all the parameters supported by the hme driver ♦ T ype ndd /dev/hme ? . (Refer to T able 3-1 through 3-8 for parameter descriptions. ) example# ndd /dev/hme ? ? (read only) transceiver_inuse (read only) link_status (read only) link_speed (read only) link_mode (read only) ipg1 (read and write) ipg2 (read and [...]

24 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 4 Setting Forced Mode This section describes how to set forced mode (not capable of auto- negotiation). ▼ T o select one of the five local transceiver capabilities and set the mode to for ced mode 1. Select one of the following capabilities: adv_100T4_cap, adv_100fdx_cap , adv_1[...]

Setting Parameters 25 4 Configuring TCP/IP for Maximum Performance This section describes how to benchmark the TCP/IP throughput and how to set the TCP/IP hiwater marks for best performance. ▼ T o benchmark the TCP/IP throughput ♦ Use the ndd command to configure the values of some of the TCP parameters for maximum performance. ▼ T o set th[...]

26 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 4 These parameter values, described in Chapter 3, are applicable to all SUNW,hme devices on the system. Refer to T able 3-2 on page 1 1 through T able 3-8 on page 16 for parameter descriptions. For example: ▼ T o set the ipg1 to 10 and ipg2 to 5 when you reboot 1. Become superuse[...]

Setting Parameters 27 4 Setting Parameters Using the hme.conf File Y ou can also specify the properties described in the section “Setting Parameters in the /etc/system File” on page 25 on a per device basis by creating the hme.conf file in the /kernel/drv directory . The properties set in the hme.conf file will override the parameters set in [...]

28 Platform Notes: The hme Fast Ethernet Device Driver — May 1996 4 4. Create the hme.conf file in the /kernel/drv directory using a text editor and add lines similar to the following to the file: • Specify name=”hme” and class=”sbus . ” • Use the reg property to specify the device, 0xe in this case. Use the value following Bus Type[...]