Advertisement

Quick Links

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

Advertisement

Table of Contents
loading

Summary of Contents for Sun Microsystems SunSAI/P

  • 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.
  • Page 3: Regulatory Compliance Statements

    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 SunSAI/P User’s Guide • November 1998...
  • Page 5: Declaration Of Conformity

    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.
  • Page 6 SunSAI/P User’s Guide • November 1998...
  • Page 7: Table Of Contents

    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...
  • Page 10 SunSAI/P User’s Guide • November 1998...
  • Page 11 FIGURE 3-1 Modem Cable 9 FIGURE 4-1 Simple Terminal/Printer Cable 11 FIGURE 4-2 Terminal/Printer Cable with DTR Handshaking 12 FIGURE 4-3 SunSAI/P Software Directory Structure (/etc and /kernel Directories) 16 FIGURE 5-1 SunSAI/P Software Directory Structure (/opt Directory) 17 FIGURE 5-2...
  • Page 12 SunSAI/P User’s Guide • November 1998...
  • Page 13 Tables DB-25 Connector Pin Assignments 5 TABLE 3-1 Format Used For Port Names 23 TABLE 5-1 sitty Options TABLE 7-1 SunVTS Documentation 41 TABLE C-1 xiii...
  • Page 14 SunSAI/P User’s Guide • November 1998...
  • Page 15: Introduction

    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.
  • Page 16: Board Operation

    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”...
  • Page 17: Installing Sunsai/P Boards

    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.
  • Page 18: Memory Window Size And Starting Address

    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.
  • Page 19: Eia-232 Connectors And Cables

    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...
  • Page 20: Cables

    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...
  • Page 21: Environment

    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...
  • Page 22 SunSAI/P User’s Guide • November 1998...
  • Page 23: Connecting Peripherals

    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...
  • Page 24: Connecting To A Dte Device

    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.
  • Page 26: Hardware Handshaking (Ready/Busy)

    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...
  • Page 27: Device Driver Installation

    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.
  • Page 28: Installing The Driver Software Using Pkgadd

    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.
  • Page 30: Directory Structure

    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...
  • Page 31 /man1 /man1m /man7d spm_info sitty spm_info1 sitty32 spm_info2 sitty64 sitty.1 saipconfig.1m saip.7d spm_info3 saipd.1m saipdl.7d spm_info4 spm32 spm.1m spm_info5 spm64 spm_info6 * Signifies a symbolic link SunSAI/P Software Directory Structure (/opt Directory) FIGURE 5-2 Chapter 5 Device Driver Installation...
  • Page 32: Loading The Driver

    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.
  • Page 33: Rebooting The System

    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).
  • Page 34: Manual Configuration

    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.
  • Page 37: Creating New Devices

    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:...
  • Page 38: Enabling The New Ports

    -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...
  • Page 39: Viewing The Man Pages

    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.
  • Page 40: Editing The Bourne Or Korn Shell Environments

    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)
  • Page 41: Un-Installing The Device Driver

    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.
  • Page 42 SunSAI/P User’s Guide • November 1998...
  • Page 43: Tty Devices

    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.
  • Page 44 SunSAI/P User’s Guide • November 1998...
  • Page 45: Setting Terminal Options With The Sitty Utility

    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.
  • Page 48 SunSAI/P User’s Guide • November 1998...
  • Page 49: Sun Port Manager

    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.
  • Page 50 SunSAI/P User’s Guide • November 1998...
  • Page 51: Error Messages

    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...
  • Page 53: Specifications

    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˚...
  • Page 54 SunSAI/P User’s Guide • November 1998...
  • Page 55: Sunvts Diagnostic Testing

    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...
  • Page 57: Index

    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...
  • Page 60 SunSAI/P User’s Guide • November 1998...

Table of Contents