Dual gigabit ethernet and dual scsi/p adapter (96 pages)
Summary of Contents for Sun Microsystems SunHSI/S 3.0
Page 1
SunHSI/S 3.0 Installation ™ and Administration Guide Sun Microsystems, Inc. 901 San Antonio Road Palo Alto, CA 94303-4900 USA 650 960-1300 Fax 650 969-9131 Part No. 805-6941-10 November 1998, Revision A Send comments about this document to: docfeedback@sun.com...
Page 2
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.
Page 3
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.
Page 4
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.
Contents Preface xiii Overview 1 Hardware Description 2 SunHSI/S Serial Channels 4 SunHSI/S-to-SBus Interface 4 Aggregate Bandwidth 4 Power Consumption 4 Software Description 5 Network Device Driver 5 Diagnostic Utilities 5 Diagnostics 5 Getting Help 6 Installing the SunHSI/S Adapter and Patch Panel 7 Tools and Equipment 7 Installing the SunHSI/S Adapter 7 Installing the SunHSI/S Patch Panel 8...
Page 6
To Power On Your System 15 Installing the SunHSI/S 3.0 Software 17 To Remove Older Versions of the SunHSI/S Software 19 To Mount the SunHSI/S 3.0 CD-ROM 20 Files and Directories on the CD-ROM 20 To Install the SunHSI/S Software 21...
Page 7
The hsi_loop Command 34 Test Type Options 36 Test Option 1 — Internal Test 36 Test Option 2 — Test Using Loopback Plugs 36 Test Option 3 — Test Using Local or Remote Modem Loopback 36 Test Option 4 — Use Previously Set Mode 37 hsi_loop Output 38 The hsi_stat Command 39 SunVTS Diagnostic Testing 43...
Page 8
IBM Half-Duplex Mode 62 IBM Multi-Point Mode 63 Hardware Functional Description 65 Integrated Serial Communications Controller (ISCC) 65 Dual-Ported 32 Kbyte Random Access Memory 66 System Clock 66 Bit Latch Controller 66 EPROM 67 Status Buffers 67 Software Functional Description 69 Initialization 69 External Interfaces 70 IOCTLs 72...
Page 9
Installing the Patch Panel Assembly in a SPARCserver 690MP 12 FIGURE 2-5 Connecting the SunHSI/S Adapter to the Patch Panel 13 FIGURE 2-6 SunHSI/S 3.0 Software Directories and Files 18 FIGURE 3-1 Null Modem Cable (Both Sun Systems Supply Clocking) 48 FIGURE A-1...
Page 10
SunHSI/S Installation and Administration Guide • November 1998...
Preface This document provides information on how to install, configure, and use the SunHSI/S™ adapter, which is a high-speed serial interface SBus adapter. These instructions are designed for a system administrator with experience installing similar hardware and software. Using UNIX Commands ®...
Page 14
Typographic Conventions Typographic Conventions TABLE P-1 Typeface Meaning Examples The names of commands, files, Edit your .login file. AaBbCc123 and directories; on-screen Use ls -a to list all files. computer output % You have mail. What you type, when AaBbCc123 contrasted with on-screen Password: computer output...
Page 15
Related Documentation You may need to refer to the following manuals when installing the SunHSI/S adapter into your system. Related Documentation TABLE P-3 Manual Operating Environment Your system installation and service manuals All supported versions Solaris Handbook for SMCC Peripherals Solaris 2.5.1, 2.6 Solaris 7 Solaris Handbook for Sun Peripherals...
Page 16
SunHSI/S Installation and Administration Guide • November 1998...
C H A P T E R Overview The SunHSI/S adapter is a four-port high-speed serial communications SBus adapter. The SunHSI/S adapter comes with a 96-pin cable, driver software, patch panel, and documentation. The SunHSI/S adapter occupies one slot of an SBus system.
Hardware Description The SunHSI/S adapter consists of two Zilog Integrated Serial Communications Controllers (ISCC), 32 KBytes of dual-ported RAM, 32 KBytes of EPROM, 3 bit-addressable latches, and various control and interface logic. A hardware block diagram is shown in FIGURE 1-2 All interface signals appear at the 96-pin connector on the rear edge of the SBus adapter.
SunHSI/S Serial Channels The four serial channels of the SunHSI/S adapter conform to the RS-449 specification for type SR interface circuits. Loopback connectors and test software are provided to verify correct operation of the interface. The SunHSI/S adapter ports are all DTE-type. The optional features for remote and local modem loopback testing as specified by the RS-449 specification are not implemented.
Software Description The SunHSI/S 3.0 software package includes a network device driver and several utilities to diagnose the functionality of the SunHSI/S device driver. Appendix E contains a functional description of the SunHSI/S software. Network Device Driver The SunHSI/S 3.0 driver provides a streams-based interface to the Solaris operating environment.
Getting Help If you have problems installing or using this product after reading this document, call your local service provider and have the following information ready: System model and serial numbers Solaris release number SunHSI/S version number (3.0) Type of keyboard Number of CPUs Number of SunHSI/S adapters You can display machine and software information needed for help calls by entering...
C H A P T E R Installing the SunHSI/S Adapter and Patch Panel This chapter explains how to install the SunHSI/S adapter in an SBus system and how to install the patch panel. Tools and Equipment You will need the following to install the SunHSI/S adapter and the patch panel: #1 Phillips screwdriver Antistatic wrist strap (provided) Installing the SunHSI/S Adapter...
4. If you are replacing an SBus adapter with the SunHSI/S adapter, remove the old adapter now. 5. Install the SunHSI/S adapter in the selected SBus slot. 6. Detach the wrist strap and close the system unit. Installing the SunHSI/S Patch Panel The SunHSI/S patch panel has four RS-449 ports for connecting the SunHSI/S adapter to RS-449 devices as shown in the following illustration.
To Mount the Patch Panel on a Wall 1. Remove the screws that secure the four rubber feet to the bottom of the patch panel ( FIGURE 2-2 2. Secure a wall mounting bracket to each end of the patch panel with the four screws removed in Step 1.
To Install the Patch Panel in a Rack 1. Remove the screws that secure the four rubber feet to the bottom of the patch panel ( FIGURE 2-3 2. Secure a mounting bracket to each end of the patch panel using the four screws removed in Step 1.
To Install the Patch Panel in a SPARCserver 690MP 1. Remove the screws that secure the four rubber feet to the bottom of the patch panel ( FIGURE 2-4 2. Secure a mounting bracket to each end of the patch panel with the four screws removed in Step 1.
Note Two patch panels are shown. RETMA rail Lockwashers (2 for each bracket) Screws (2 for each bracket) Patch panel Installing the Patch Panel Assembly in a SPARCserver 690MP FIGURE 2-5 SunHSI/S Installation and Administration Guide • November 1998...
Connecting the 96-Pin Cable The 96-pin shielded cable is used to connect the patch panel to the SunHSI/S adapter ( FIGURE 2-6 To Connect the Patch Panel to the SunHSI/S Adapter With the 96-pin Cable Note – When configuring your SunHSI/S cabling, make the connection to your SunHSI/S adapter after you have made the connection to the other end.
SunHSI/S Cabling The SunHSI/S adapter provides connectivity to four RS-449 devices through four DB-37 female connectors (DTE) on a patch panel. Note – Always use twisted-pair RS-449 cables with your SunHSI/S adapter. RS-232 to RS-449 Connections In order to connect RS-232 devices to the SunHSI/S adapter, you need to install an externally powered RS-449 to RS-232 interface converter to each DB-37 connector on which you intend to connect an RS-232 device.
To Power On Your System 1. Make sure all cable connections are secure. 2. Power on your system. Refer to your system installation or service manual for the specific instructions for your system. When the power is turned on, a banner similar to the following will be displayed on the screen: SPARCstation X.
Page 32
5. Reboot the system. Refer to the Solaris on Sun Peripherals for more information. After the system reboots, install the SunHSI/S 3.0 software as described in Chapter 3. SunHSI/S Installation and Administration Guide • November 1998...
C H A P T E R Installing the SunHSI/S 3.0 Software This chapter describes how to install the SunHSI/S 3.0 software by: Checking for previous versions of the SunHSI/S software Mounting the SunHSI/S 3.0 CD-ROM Using the pkgadd(1m) utility to install the software packages...
To Remove Older Versions of the SunHSI/S Software Before installing the SunHSI/S 3.0 software on your system, check your system to see if previous versions of the SunHSI/S software is installed. If older SunHSI/S software exists (before version 3.0), you must remove this software before installing the new SunHSI/S 3.0 software.
To Mount the SunHSI/S 3.0 CD-ROM 1. Become superuser. 2. Insert the SunHSI/S 3.0 CD into a CD-ROM drive that is connected to your system. If your system is running Volume Manager, it should automatically mount the CD to the /cdrom/sunhsis_3_0 directory.
To Install the SunHSI/S Software 1. As superuser, type the following to install the SunHSI/S 3.0 software packages from the CD: # pkgadd -d /cdrom/sunhsis_3_0/Product SUNWhsis SUNWhsism SUNWhsisu 2. When prompted, answer y to permit pkgadd to launch the post-installation script: This package contains scripts which will be executed with superuser permission during the process of installing this package.
Before Operating the SunHSI/S Adapter Changing the Cabling or Equipment If you make any cabling or equipment changes on a port (for example, changing modems), you must reset the port with the hsi_init reset command (N represents the SunHSI/S port number): # hsi_init hihN reset After all the changes have been made, re-initialize the port with the hsi_init command.
For example, if you added the MANPATH line to the .login file, you would type: % source $HOME/.login Note – If you log out and then back into your system, you will update the MANPATH variable in all command windows and shells. Chapter 3 Installing the SunHSI/S 3.0 Software...
MANPATH variable in all command windows and shells. Removing the SunHSI/S 3.0 Software Use the pkgrm command to remove the SunHSI/S 3.0 software from your system. As superuser (root), use the pkgrm command to remove the SunHSI/S 3.0 software packages: # /usr/sbin/pkgrm SUNWhsis SUNWhsism SUNWhsisu SunHSI/S Installation and Administration Guide •...
SunHSI/S driver received a DL_ATTACH_REQ, which has an out-of-range PPA number N, from upper layers. hihN: port N not installed The SunHSI/S port N, which is referenced by the PPA number in a received DL_ATTACH_REQ message, is not installed to the system. Chapter 3 Installing the SunHSI/S 3.0 Software...
hihN: out of STREAMS mblocks Running out of streams mblocks for SunHSI/S port N. hihN: xmit hung Transmission hung on SunHSI/S port N. This usually happens because of cabling problems or due to missing clocks from the CSU/DSU or modem. hihN: <hih_rxsoft>...
C H A P T E R SunHSI/S Utilities and SunVTS Diagnostic Testing This chapter describes the utilities associated with SunHSI/S interface driver, and it provides information about the SunVTS™ diagnostic software. The SunHSI/S software ships with its own version of the serial port utilities. In general, the SunHSI/S utilities provide a superset of the features described in this chapter.
Software Port Names The port naming conventions are used by initialization and serial port diagnostic commands. Software port names for SunHSI/S ports are of the form hihN, where N is a number in a range starting with 0 and ending at one fewer than the number of serial ports on your machine.
The hsi_init Command The hsi_init command allows you to display and modify some of the hardware operating modes common to high speed serial lines. These features make the hsi_init command valuable when troubleshooting and repairing problematic serial link lines. Other applications also use the hsi_init command. For example, some applications use the hsi_init command to initialize serial ports, and the hsi_loop command (described in “The hsi_loop Command”...
To set these parameters, use the syntax hsi_init portname keyword=value. For example, to set the maximum transmission unit (mtu) parameter of port hih2 to 1000 bytes, you would type: # hsi_init hih2 mtu=1000 displays the possible values for each of these hsi_init parameters, and TABLE 4-3 lists the default values as initialized by the SunHSI/S driver for each port.
Page 47
speed The speed parameter sets the line speed, or baud rate, of the serial line in bits per second. You can set this parameter to be from 0 to 2048000 bps. In most situations, the actual line speed is determined by the modems in use, not by the Sun hardware, so the speed set by hsi_init is used only for compiling performance statistics for the hsi_stat command (see “The hsi_stat Command”...
Page 48
NRZI data encoding does a voltage transition when data is absent (voltage level 0), and it does not do a voltage transition (no return to 0) when data is present (voltage level 0). With NRZI, the data is decoded using relational decoding.
mtu/mru The mtu parameter sets the packet size of the maximum transmission unit, and the mru parameter sets the packet size of the maximum receive unit. By adjusting these parameters, you may achieve better performance out of the link. Both of these parameters can be set between 1 and 1600 bytes.
The hsi_loop Command The hsi_loop command performs a loopback test that checks the following components of your communications link: Port-driver software layering CPU-to-port communication Correct operation of the serial port Cable from port to modem (or modem equivalent) Local and remote modems (or modem equivalents) Transmission line When you invoke hsi_loop, it runs the hsi_init command to initialize the serial port and send out packets.
The options for hsi_loop are described in TABLE 4-5 hsi_loop Options TABLE 4-5 Option Parameter Name Description packet count Specifies the number of packets used for data transfer. The default is 100. packet length Specifies the length of the packet in bytes. The default is 100; the maximum is 1600.
Test Type Options Listed below are descriptions of the available test type options. You specify test type options with the -t option, as described in TABLE 4-5 Test Option 1 — Internal Test This option uses the internal clocking and internal loopback and runs the following hsi_init command: hsi_init portname speed loopback=yes txc=baud rxc=baud The test data packets (100 by default) are sent to the specified serial port and looped...
With test type option 3, hsi_loop treats both local and remote modem loopback testing the same, since clocking is provided by the modem in both cases. Whether the data is looped back through the local or remote modem depends on how the modems are set up.
hsi_loop Output When the loopback test runs successfully, using any of the test type options, hsi_loop reports the statistics shown in the following sample output and then terminates. # hsi_loop hih1 Enter test type: 1: Internal Test (internal data loop, internal clocking) 2: Test using loopback plugs (external data loop, internal clocking) 3: Test using local or remote modem loopback...
The hsi_stat Command The hsi_stat command gives you information about the packets transmitted and received on a synchronous serial line. The hsi_stat command is a valuable tool for monitoring your serial link. The syntax for hsi_stat depends on whether you want to display the statistics of a single port or a number of ports.
describes the statistics in the hsi_stat output. TABLE 4-6 hsi_stat Statistic Descriptions TABLE 4-6 Statistic Description Reports the line speed as set by hsi_init It is the system speed administrator’s responsibility to make this value correspond to the modem clocking speed when clocking is provided by the modem. Reports the total number of input packets.
Page 57
hsi_stat Statistic Descriptions (Continued) TABLE 4-6 Statistic Description Reports the number or input packets received when receive is inactive inactive. Reports the number of short input packets. This is the number of ishort packets received with lengths less than the number of CRC bytes. Reports the number of long input packets.
Page 58
would produce output similar to the following. Note that in this example, the display will be updated every ten seconds. ipkts opkts undrun ovrrun abort crc iutil outil Hit Control-C to exit. Using the hsi_stat command with an interval adds two fields to the report: iutil and outil.
SunVTS Diagnostic Testing The SunVTS software executes multiple diagnostic hardware tests from a single user interface and is used to verify the configuration and the functionality of most hardware controllers and devices. The SunVTS diagnostic primarily operates from a user interface that allows you to control all aspects of the diagnostic test operation. The sunlink diagnostic test, which is shipped with the SunVTS software, checks the functionality of SunHSI/S adapters.
Page 60
SunVTS TTY interface The vtstty TTY user interface controls vtsk from either a command shell or a terminal attached to a serial port. Most options available in vtsui have equivalent options in vtstty. SunHSI/S Installation and Administration Guide • November 1998...
A P P E N D I X Building a Synchronous Null Modem Cable and an X.21-to-RS- 449 Converter Null Modem Cable Requirements A synchronous null modem cable is a specially configured cable that simulates back-to-back modems. When the distance between two hosts is not great, you may be able to use a null modem cable instead of a synchronous modem or a synchronous modem eliminator.
Configuring Internal or External Clocking To configure an RS-449 port to provide transmit clocking for itself as well as receive clocking for the other end of the link, set the txc (transmit clock) and rxc (receive clock) parameters in hsi_init to baud and rxc, respectively. For example, the following hsi_init command, sets the data rate of the first CPU serial port to 9600 bps and sets the clocking as just described: # hsi_init hih0 9600 txc=baud rxc=rxc...
RS-449 Null Modem Cable list the signals and names for RS-449 and X.21 circuits. TABLE A-1 TABLE A-2 RS-449 Signals TABLE A-1 Pin Numbers on Circuit Name Direction DB-37 Connector Transmit Data To DCE 4, 22 Receive Data From DCE 6, 24 Transmit Clock To DCE...
Because the RS-449 interface is balanced, there are two pins for each signal. For example, Transmit Data (TxD), pins 4 and 22, is connected to Receive Data (RxD), pins 6 and 24. This means that pin 4 is connected to pin 6 and pin 22 is connected to pin 24.
RS-449 Implementation Example The RS-449 implementation illustrated in is not necessarily a functional FIGURE A-4 design. Instead, its purpose is to show basic design considerations. DB37 RCV Ext Clock 100 ohm RS422 RTxC RCVR Clear To Send Data Carrier Detect 26LS Receive Data ISCC...
RS-449 Pin Assignments and Descriptions describes the functions of the RS-449 signals and their pinouts. TABLE A-3 Functional Description of RS-449 Interface Signals TABLE A-3 RS-449 Pin # Signal Name Function Shield Ground Allows tandem sections of shielded cable to retain continuity through the connector.
96-Pin Connector Signal and Pin Assignments lists the pin and signal descriptions of the 96-pin connector. Note that TABLE A-4 there are no connections to pins 2, 23, 26, 47, 50, 71, or 95. 96-Pin Connector Pin and Signal Assignments TABLE A-4 From J1 To Channel...
Page 70
96-Pin Connector Pin and Signal Assignments (Continued) TABLE A-4 From J1 To Channel Direction Signal Description From DCE +BB Receive Data From DCE -BB Receive Data To DCE +DA Transmit Clock To DCE -DA Transmit Clock From DCE +DB Transmit Clock In From DCE -DB Transmit Clock In From DCE...
Page 71
96-Pin Connector Pin and Signal Assignments (Continued) TABLE A-4 From J1 To Channel Direction Signal Description To DCE +CA Request-to-Send To DCE -CA Request-to-Send From DCE +CB Clear-to-Send From DCE -CB Clear-to-Send From DCE +CC Data Set Ready From DCE -CC Data Set Ready To DCE +CD Data Terminal Ready...
Page 72
96-Pin Connector Pin and Signal Assignments (Continued) TABLE A-4 From J1 To Channel Direction Signal Description To DCE -CD Data Terminal Ready From DCE +CF Data Carrier Detect From DCE -CF Data Carrier Detect SunHSI/S Installation and Administration Guide • November 1998...
- transmit clock signal rxc - receive clock signal The effect of the default settings for all of these parameters is that SunHSI/S 3.0 software does not invert the data or clock signal controlled by the parameter. To invert a signal, you specify a setting of the form param_name=-paramname, for example, txc=-txc.
Inverted Settings The reason for inverting data signals is distinct from the reason for inverting clock signals. The background for data signal inversion is explained first, then the background for clock signal inversion is explained. Data Signal Inversion The requirement for inverting data signals arises from the “ones density” problem you encounter with most T1 transmission lines in North America.
for data transmission, which means that 12.5 percent of the bandwidth of the T1 line is wasted. When you consider that the lease cost for a coast-to-coast T1 line can be exceedingly expensive, this waste of bandwidth can be unacceptable. There are alternatives.
Page 76
When using long cables or cables not carrying a clock signal, a phase shift may occur causing a high number of errors. In such cases, inverting the clock signal may correct the phase shift. You may also need to invert the clock signal when connecting a SunHSI/S port to equipment not adhering to the RS-334 standard.
A P P E N D I X hsi_init Options for Operating Modes This appendix describes the operating modes that can be set by the hsi_init utility (see “The hsi_init Command” on page 29 for instructions on how to use this utility). The SunHSI/S driver operates in two main operating modes, the high-level data link control (HDLC) mode and the IBM (SDLC) mode.
IBM (SDLC) Mode This mode is designed to support IBM system network architecture (SNA) communications. It uses most of the same protocols used in HDLC mode, with two major exceptions: When the line is idle, instead of sending flag bytes, the transmitter is disabled. The request-to-send (RTS) and clear-to-send (CTS) signals are used to gate transmission.
Page 79
IBM Multi-Point Mode In a multi-point configuration (mode=ibm-mpt), more than two stations “share” a link. This configuration is accomplished by designating one station as a primary station and the rest as secondary stations. In this mode, the port acts as a secondary station.
Page 80
SunHSI/S Installation and Administration Guide • November 1998...
Page 81
A P P E N D I X Hardware Functional Description This appendix contains a detailed description of the hardware block diagram ) in Chapter 1. FIGURE 1-2 SunHSI/S provides four synchronous serial communications channels for any slave host. Each channel can operate at a maximum speed of 2.048 Mbps, and each supports a separate RS-449 interface.
Page 82
An internal four-channel DMA provides full-duplex operation for both ISCC serial channels. Bus utilization is optimized by incorporating the internal packet status FIFO and the internal DMA, which reduces host intervention. Dual-Ported 32 Kbyte Random Access Memory The use of dual-ported random access memory (RAM) minimizes bus contention between the host and the serial controllers.
EPROM SunHSI/S supports up to 32 Kbytes of read-only memory. This EPROM is only used for supplying the required ID string of data that begins at location zero of the physical address for the slot in which the SunHSI/S adapter is installed. Status Buffers A buffer is used to report the status of the CF signal (Receive Line Detector) from the DCE.
Page 84
SunHSI/S Installation and Administration Guide • November 1998...
Page 85
This autoconfiguration feature is provided in the Solaris software and it is also supported in the SunHSI/S 3.0 driver software. After the autoconfiguration, the module is unloaded. The driver module is loaded to the system again when the driver is first referenced.
Page 86
External Interfaces The SunHSI/S 3.0 driver provides a streams-based interface to the Solaris kernel and user program. The driver software can be reached from user program through standard open(2), close(2), putmsg(2), getmsg(2), and ioctl(2) system calls.
IOCTLs All driver control is achieved through IOCL(2) system call. lists the IOCTL TABLE E-1 parameters for the SunHSI/S Driver. IOCTL Parameters for the SunHSI/S Driver TABLE E-1 IOCTL Name Purpose and Structure Retrieves the current transmission parameters setting for a particular port. Structure S_IOCGETMODE required: struct scc_mode {...
Page 89
IOCTL Parameters for the SunHSI/S Driver (Continued) TABLE E-1 IOCTL Name Purpose and Structure Retrieves the data or errors statistics that SunHSI/S driver has accumulated for a S_IOCGETSTATS particular port. Structure Required: struct hs_stats long ipack; /*input packets*/ long opack; /*output packets*/ long ichar;...
IOCTL Parameters for the SunHSI/S Driver (Continued) TABLE E-1 IOCTL Name Purpose and Structure Clears the data and error statistics that SunHSI/S driver has accumulated for a S_IOCCLRSTATS particular port. Structure Required: Same as S_IOCGETSTATS The scc_mode and sl_stats structures defined in the system include file (/usr/include/sys/ser_sync.h).
Page 91
Packet Transmission and Reception When an upper-protocol layer or a user program has a packet ready for transmission by the interface, it calls either the putnext(9F) utility or the putmsg(2) system call to pass the packet to the SunHSI/S driver. If the SunHSI/S driver transmission buffer is empty, the hih_wput routine of the driver copies the packet into the RAM buffer on the SunHSI/S adapter.
Page 92
SunHSI/S Installation and Administration Guide • November 1998...
Need help?
Do you have a question about the SunHSI/S 3.0 and is the answer not in the manual?
Questions and answers