Page 1
SunSAI/P User’s Guide Sun Microsystems, Inc. 901 San Antonio Road Palo Alto, CA 94303-4900 USA 650 960-1300 Fax 650 969-9131 Part No. 805-6947-10 November 1998, Revision A Send comments about this document to: docfeedback@sun.com...
Page 2
Sun, Sun Microsystems, the Sun logo, AnswerBook, Java, the Java Coffee Cup, SunVTS, SunSolve, OpenBoot, and Solaris are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc.
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.
Declaration of Conformity Compliance ID: DIGI-70000414 Product Name: SunSAI/P Adapter This product has been tested and complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: 1. This equipment may not cause harmful interference.
Introduction 1 Components 1 Features 1 Board Operation 2 Customer Assistance 2 Installing SunSAI/P Boards 3 Before You Install the Board 3 Installing the Board 3 Memory Window Size and Starting Address 4 EIA-232 Connectors and Cables 5 Connectors 5...
Page 8
Viewing the Man Pages 26 Un-Installing the Device Driver 27 TTY Devices 29 Setting Terminal Options with the sitty Utility 31 Sun Port Manager 35 Using SPM 35 Error Messages 37 Specifications 39 Power Requirements 39 viii SunSAI/P User’s Guide • November 1998...
Page 9
Board Dimensions 39 Operating Environment 39 Serial Interface Surge Suppression 39 SunVTS Diagnostic Testing 41 Index 43 Contents...
C H A P T E R Introduction The SunSAI/P User’s Guide covers the installation and configuration of the SunSAI/P intelligent serial communications boards in Sun™ Microsystems™ PCI workstations running the Solaris™ 2.5.1 Hardware: 4/97, 8/97, 11/97, Solaris 2.6, and Solaris 7 operating environments.
The SunSAI/P board is a multi channel intelligent Serial Asynchronous Interface board for computers incorporating the PCI bus standard. The heart of the SunSAI/P board is a 32-bit RISC processor. The board has 128 KB of dual-ported high-speed RAM used for program code and data buffering. The SunSAI/P board supports “preset”...
Installing the Board Now you are ready to install the SunSAI/P board in your computer. Follow these steps: Note – Refer to your system installation or service manual for detailed instructions for the following steps.
4. Install the connector box assembly on the SunSAI/P board by connecting the male 78-pin plug on the assembly to the female 78-pin connector on the end of the SunSAI/P board. Be sure that the plug is completely installed—it may be a snug fit.
C H A P T E R EIA-232 Connectors and Cables Connectors SunSAI/P boards are shipped with a connector box which provides eight female DB-25 EIA-232 connectors wired for data terminal equipment (DTE) operation. DB-25 Connector Pin Assignments TABLE 3-1...
EIA-232 serial interface cables should be shielded, low capacitance cables, ideally designed specifically for serial data transmission. Grounding The shield should be grounded at both ends of the cable. Chassis Ground, available on the shell of the DB-25 connectors, is ideal for this purpose. SunSAI/P User’s Guide • November 1998...
EIA-232 interface. Short-haul modems are similar to standard modems, except that they are connected directly to each other via a cable instead of going through a telephone circuit. Note – Use only externally-powered short-haul modems with the SunSAI/P adapter. Chapter 3...
Sample cable diagrams are provided to aid in constructing the correct cable for your application. Note – The cables shown in this section are for information only and are not supplied by Sun Microsystems. Connecting to a Modem Modem Cable...
FCC certification requirements, and the shield should be connected to Chassis Ground (GND) at both ends of the cable run. A simple cable for connecting a terminal or a printer to a DB-25 equipped SunSAI/P board is shown below.
Page 25
Host Adapter Peripheral (DB-25 Male) (DB-25 Male) Signal Signal Shell Cable Shield) Simple Terminal/Printer Cable FIGURE 4-2 Note – Shielded cable must be used to remain in compliance with Part 15 of FCC rules. The cable shown in is a three-wire null modem cable—that is, Transmitted FIGURE 4-2 Data on one end of the cable is connected to Received Data at the other end, and vice versa.
Send Data (SSD) instead of DTR. In this case, simply connect CTS on the female DB- 25 side to pin 11 of the male DB-25, instead of pin 20. Other printer manufacturers may use different methods of flow control. Consult your printer's documentation for specific wiring requirements. SunSAI/P User’s Guide • November 1998...
Driver Software Before installing the SunSAI/P driver software, you must first remove any previous version of the SunSAI/P software that may be present on your system. If you attempt to add the software packages over existing SunSAI/P packages, the installation will fail.
Installing the Driver Software Using pkgadd 1. Log onto your system console as superuser (root). 2. Insert the SunSAI/P CD into your system’s CD-ROM drive. The Solaris volume management software will mount the CD to the /cdrom/sunsaip_2_0 directory. 3. To start the software installation, type: # pkgadd -d /cdrom/sunsaip_2_0/Product SUNWsaip SUNWsaipu Note –...
Page 29
Processing package instance <SUNWsaipu> from </cdrom/sunsaip_2_0/Product> Serial Asynchronous Interface Utilities (PCI) (sparc) 2.0,REV=year.month.day Copyright 1998 Sun Microsystems, Inc. All rights reserved. Using </opt> as the package base directory. 5. Answer yes (y) when asked to allow scripts to be run as superuser on your system.
Directory Structure shows the directory structure of the SunSAI/P software FIGURE 5-1 FIGURE 5-2 after it has been installed on your system. root /etc /kernel /init.d /opt /rc0.d /rc1.d /rc2.d /rcS.d /drv saip /SUNWconn K90saip K90saip S29saip K90saip saip /sparcv9 saip.conf...
Using saipconfig to Configure the Driver Software In some circumstances, you may want to configure the SunSAI/P device driver manually. For example, you may want to use more adapters than are currently loaded in the system, or you may need to change the default configuration. After you have installed the driver software, use the saipconfig utility to configure the driver software.
2. Perform a reconfiguration book by typing the following at the OpenBoot prompt: ok boot -r Automatic Configuration Follow this procedure to use the saipconfig utility to configure the SunSAI/P interfaces on your system automatically. 1. Log onto to your system console as superuser (root).
Configuration Completed. Manual Configuration Use the saipconfig utility to configure the SunSAI/P adapters on your system manually. The utility will ask you a series of questions about how you want to customize the adapters. After you have answered these questions, the utility will reconfigure the driver software.
Page 35
5. Type the number of SunSAI/P adapters you want to configure on your system: How many adapters do you wish to install (1-12)? For each adapter that you specified in Step 5, you will be asked the questions shown in Step 6 and Step 7.
Page 36
Hit <CR> to re-configure adapter #1: Press the Return key to return to Step 6. After answering these questions for all of the SunSAI/P adapters on your system, saipconfig will configure the interfaces automatically. When saipconfig has finished configuring the interfaces, you will see this message: Configuration Completed.
Devices have been created in /dev, giving the operating system the information to use the additional ports. The device driver will support up to 12 SunSAI/P adapters, depending upon your system. The devices are named according to the following convention:...
-m "‘ttyadm -d /dev/cua/a000 -l 9600 -s /usr/bin/login‘" This will enable the port suitably for a terminal. Note – Ports may also be enabled through the Solaris admintool program. Refer to the System Administration Guide for more information. SunSAI/P User’s Guide • November 1998...
Viewing the Man Pages The SunSAI/P man pages are installed in the /opt/SUNWconn/man/ directory. Before you can view the man pages, you will need to add this directory to your MANPATH environment variable. The location of the MANPATH variable will depend on which UNIX shell you are using.
Note – If you log out and then back into to your system, you will update the MANPATH variable in all command windows and shells. Viewing the Man Pages Once you have added the /opt/SUNWconn/man/ directory to your MANPATH variable, you can use the /usr/man command to view these SunSAI/P man pages: saip(7d) saipconfig(1m) saipd(1m)
Un-Installing the Device Driver Enter the following commands to un-install the device driver software: 1. Log onto the console as super-user (root). 2. Enter the following command: # /usr/sbin/pkgrm SUNWsaip SUNWsaipu 3. You will see: This package contains scripts which will be executed with super-user permission during the process of removing this package.
C H A P T E R TTY Devices This device driver supports two different device types on each line. On line “a000”, where “a” refers to the first SunSAI/P board, and “000” refers to first line (port) on that board, there are two devices: /dev/term/a000 Dial-in TTY device, used for terminals, modems, printers, laboratory equipment, etc.
The full pathname for the command is /opt/SUNWconn/bin/sitty. The format is: sitty [-a] [option(s)] [< ttyname] With no options, sitty displays all SunSAI/P special driver settings, modem signals, and all standard parameters for the TTY device referenced by standard input.
Page 46
Options TABLE 7-1 Option Description Display all of the unique SunSAI/P option settings, as well as all of the standard TTY settings reported by stty -a. ttyname Set and display options for the given TTY device, instead of standard input. ttyname is the full pathname (e.g.
Page 47
sitty Options (Continued) TABLE 7-1 Option Description The default value for edelay is 100. This is a good value for normal TTY activity like typing. For some applications like uucp, decreasing the edelay value may increase character throughput, but will result in increased system overhead. For applications receiving continuous input at high speeds, increasing edelay will result in lowering host overhead and increasing overall system throughput.
Sun Port Manager (SPM) is a software tool which provides a means to monitor the status of the Front End Processor/Operating System (FEP/OS), which is the on- board software run by the SunSAI/P. SPM also shows the status of the individual ports on a module by displaying a simulated modem status register.
A P P E N D I X Error Messages The following error messages are generated by the device driver: WARNING: PCI SAI/8 memory allocation error. <2> What it means: The operating system would not allocate memory to the driver. Action to take: Adjust kernel resources.
Page 52
What it means: The driver found a board in the system that had not been configured. Action to take: De-install driver with pkgrm. Install driver with pkgadd. Either use the auto-install option or select the appropriate number of boards. SunSAI/P User’s Guide • November 1998...
A P P E N D I X Specifications Power Requirements +5 VDC 5%:960 mA typical +12 VDC 5%:80 mA typical -12 VDC 5%:80 mA typical +3.3 VDC 5%:20 mA maximum Board Dimensions Length: 6.875 inches Width: 0.5 inches Height: 4.2 inches Weight: 6.1 ounces Operating Environment Ambient temperature: 10˚...
The saiptest diagnostic, which is shipped with the SunVTS software, checks the functionality of SunSAI/P adapters. This diagnostic can be run from the SunVTS user interface, or it can be run from the command line. Refer to the SunVTS Test Reference Manual for more information about the saiptest test.
Page 56
Most options available in vtsui have equivalent options in vtstty. Note – Some of the saiptest tests require a EIA-232 loopback plug, which can be ordered through Sun (part number: 540-1558). SunSAI/P User’s Guide • November 1998...
Index pin assignments, 5 declaration of conformity, v board dimensions, 39 device driver boot -r command, 19 see software devices DTE, 10 DTR, 12 cables, 6 to 7 naming convention, 23 capacitance, 7 tty names, 29 diagrams, 9, 11, 12 diagnostic, 41 environment, 7 dial-in devices, 23, 29...
Page 58
14 to 15 man pages, viewing, 25 null modem cable, 10 new devices, 23 removing old versions, 13 Sun port manager, 35 supported Solaris versions, 1 un-installing, 27 on-board memory, 2 Solaris environment SunSAI/P User’s Guide • November 1998...
Page 59
supported versions, 1 specifications board dimensions, 39 environment, 39 power requirements, 39 serial interface surge suppression, 39 SPM, 35 starting, 35 Sun port manager, 35 starting, 35 SunSolve website, 2 SunVTS diagnostic, 41 un-installing software, 27 Index...