background image

901 San Antonio Road
Palo Alto, CA 94303-4900 USA
650 960-1300

Fax 650 969-9131

SunSAI/P User’s Guide

Part No. 805-6947-10
November 1998, Revision A

Sun Microsystems, Inc.

Send comments about this document to:

 [email protected]

Summary of Contents for SunSAI/P

Page 1: ...onio Road Palo Alto CA 94303 4900 USA 650 960 1300 Fax 650 969 9131 SunSAI P User s Guide Part No 805 6947 10 November 1998 Revision A Sun Microsystems Inc Send comments about this document to docfeedback sun com ...

Page 2: ... Sun Microsystems Inc 901 San Antonio Road Palo Alto CA 94303 Etats Unis Tous droits réservés Ce produit ou document est proté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 document ne peut être reproduite sous aucune forme par quelque moyen que ce soit sans l autorisation préalable et...

Page 3: ...ere is no guarantee that interference will not occur in a particular installation If this equipment does cause harmful interference to radio or television reception which can be determined by turning the equipment off and on the user is encouraged to try to correct the interference by one or more of the following measures Reorient or relocate the receiving antenna Increase the separation between t...

Page 4: ...iv SunSAI P User s Guide November 1998 ...

Page 5: ...ss B EN50082 1 IEC801 2 1991 4 kV Direct 8 kV Air IEC801 3 1984 3 V m IEC801 4 1988 1 0 kV Power Lines 0 5 kV Signal Lines EN61000 3 2 IEC1000 3 2 1994 Pass Class D Supplementary Information This product was tested and complies with all the requirements for the CE Mark when connected to a Sun workstation or server S S Dennis P Symanski DATE John Shades DATE Manager Product Compliance Quality Assur...

Page 6: ...vi SunSAI P User s Guide November 1998 ...

Page 7: ... SunSAI P Boards 3 Before You Install the Board 3 Installing the Board 3 Memory Window Size and Starting Address 4 3 EIA 232 Connectors and Cables 5 Connectors 5 Cables 6 Grounding 6 Environment 7 Capacitance vs Length of Run 7 4 Connecting Peripherals 9 Connecting to a Modem 9 Connecting to a DTE Device 10 ...

Page 8: ...fig to Configure the Driver Software 18 Rebooting the System 19 Automatic Configuration 19 Manual Configuration 20 Creating New Devices 23 Enabling the New Ports 24 Viewing the Man Pages 25 Editing the C Shell Environment 25 Editing the Bourne or Korn Shell Environments 26 Viewing the Man Pages 26 Un Installing the Device Driver 27 6 TTY Devices 29 7 Setting Terminal Options with the sitty Utility...

Page 9: ...Contents ix Board Dimensions 39 Operating Environment 39 Serial Interface Surge Suppression 39 C SunVTS Diagnostic Testing 41 Index 43 ...

Page 10: ...x SunSAI P User s Guide November 1998 ...

Page 11: ... Modem Cable 9 FIGURE 4 2 Simple Terminal Printer Cable 11 FIGURE 4 3 Terminal Printer Cable with DTR Handshaking 12 FIGURE 5 1 SunSAI P Software Directory Structure etc and kernel Directories 16 FIGURE 5 2 SunSAI P Software Directory Structure opt Directory 17 ...

Page 12: ...xii SunSAI P User s Guide November 1998 ...

Page 13: ...xiii Tables TABLE 3 1 DB 25 Connector Pin Assignments 5 TABLE 5 1 Format Used For Port Names 23 TABLE 7 1 sitty Options 32 TABLE C 1 SunVTS Documentation 41 ...

Page 14: ...xiv SunSAI P User s Guide November 1998 ...

Page 15: ... can communicate with the board Device driver installation instructions are included in this manual after the hardware installation instructions Components The carton in which your SunSAI P board was shipped should contain the following items SunSAI P board SunSAI P User s Guide this book One or more software packets containing device driver CD ROM Connector assembly Features Serial asynchronous b...

Page 16: ...s memory which is accessible for read and write operations by both the board and the computer To the computer the dual ported RAM looks exactly like its own memory and can be accessed by the same high speed memory referencing commands it uses for its internal memory This means that a block of data that may take a number of seconds for the SunSAI P board to receive or transmit to the outside world ...

Page 17: ...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 1 Power off your system using the standard shut down procedures described in the Solaris Handbook for Sun Peripherals or your system service manual The Solaris Handbook for Sun Peripherals is shipped with the Solaris operating environment sof...

Page 18: ...dplate screw once the DB 78 connector is securely attached 5 Screw the connector into the board s endplate Do not over tighten the screws If the screws don t go in several turns or if they don t reach the nuts in the endplate the 78 pin connectors are probably not completely mated 6 Replace your computer s cover 7 Power on your system using the procedures described in the Solaris Handbook for Sun ...

Page 19: ...he DB 25 connectors follow the usual conventions for EIA 232 wiring TABLE 3 1 DB 25 Connector Pin Assignments Signal Description DTE Use Pin GND Chassis Ground N A Shell TxD Transmitted Data Output 2 RxD Received Data Input 3 RTS Request To Send Output 4 CTS Clear To Send Input 5 DSR Data Set Ready Input 6 SG Signal Ground reference 7 DCD Data Carrier Detect Input 8 DTR Data Terminal Ready Output ...

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

Page 21: ...al interface cable is usually rated in pico Farads per foot Therefore if a cable has a capacitance of 50 pF ft and the connectors are 100 pF each the maximum recommended cable length is 46 feet for baud rates of up to 57 600 If the cable is rated at 12 5 pF ft the maximum recommended cable length is 184 feet and 5 pF ft cable can be run up to 460 feet In situations where low capacitance cable is u...

Page 22: ...8 SunSAI P User s Guide November 1998 ...

Page 23: ... peripheral devices to the SunSAI P adapter 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 FIGURE 4 1 Modem Cable ...

Page 24: ...E device to another DTE device you need a null modem cable or adapter Software Handshaking XON XOFF In most cases serial terminals and printers need only a three wire connection to the SunSAI P board The Solaris device driver supports XON XOFF software handshaking so the only signal lines necessary are Transmitted Data TxD Received Data RxD and Signal Ground SG Cables must be shielded to remain in...

Page 25: ...e is connected to Received Data at the other end and vice versa The male DB 25 end can be plugged directly into most serial terminals and printers without any adapters The female DB 25 end plugs directly into one of the DB 25 connectors on the connector box assembly Host Adapter DB 25 Male Peripheral DB 25 Male 1 2 3 4 5 6 7 8 20 22 Pin Pin GND TxD RxD RTS CTS DSR SG DCD DTR RI GND TxD RxD RTS CTS...

Page 26: ... Some Okidata printers use a control signal on pin 11 called Supervisory 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 1 2 3 4 5 6 7 8 20 22 Pin Pin GND TxD RxD RTS CTS DSR S...

Page 27: ...u 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 1 Become superuser root 2 Check for any SunSAI P software packages by using the pkginfo command If you find any SunSAI P packages you must remove them 3 Remove any existing SunSAI P software packa...

Page 28: ...ing package instance SUNWsaip from cdrom sunsaip_2_0 Product Serial Asynchronous Interface Driver PCI sparc 2 0 REV year month day Copyright 1998 Sun Microsystems Inc All rights reserved Automatically installing the default configuration To reconfigure or add new adapters use the saipconfig utility The following has been automatically configured for adapter 1 Adapter Type 8 port PCI Async Intellig...

Page 29: ...ge contains scripts which will be executed with super user permission during the process of installing this package Do you want to continue with the installation of SUNWsaip y n y Installation of SUNWsaip was successful 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 Al...

Page 30: ...as been installed on your system FIGURE 5 1 SunSAI P Software Directory Structure etc and kernel Directories root etc kernel opt SUNWconn rcS d drv saipconfig saipd saipd32 saipd64 saip saip conf saipdl saipdl conf K90saip saip saipdl sparcv9 saip bin Signifies a symbolic link bin saipconfig saipd rc0 d K90saip rc1 d K90saip rc2 d S29saip init d saip ...

Page 31: ...sitty sitty32 sitty64 spm spm32 spm64 saip h saip 7d saipconfig 1m saipd 1m saipdl 7d sitty 1 spm 1m man1m man7d spm_info spm_info1 spm_info2 spm_info3 spm_info4 spm_info5 spm_info6 saip bin Signifies a symbolic link root include saip h info man1 man saip 7d saipconfig 1m saipd 1m saipdl 7d sitty 1 spm 1m man1m man7d man1 sitty spm ...

Page 32: ...ty options should be added to the end of etc rc2 d This can be done by giving it a name such as S99saip or S99sittystuff where the S must be a capital letter and the greater the number the later the script is run 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 ar...

Page 33: ... shutdown command Refer to the shutdown 1m man page for more information 2 Perform a reconfiguration book by typing the following at the OpenBoot prompt 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 2 To start the saipconfig utility type 3 Answer yes y...

Page 34: ...er root 2 To start the saipconfig utility type 3 To configure the adapters manually answer no n to this question The saipconfig utility will ask you questions about how you want to configure the SunSAI P interfaces 4 Press the Return key to configure your driver software Configuration Completed etc opt SUNWconn bin saipconfig The installation has detected 1 SunSAI P serial adapter Would you like t...

Page 35: ...terrupts on the adapter Note We recommend that you use the default setting of disabled interrupts How many adapters do you wish to install 1 12 Configuring adapter 1 Adapter type is 8 port PCI Async Intelligent Adapter 8 port adapter In order to reduce response time to small packets latency it may be helpful to enable interrupts on the adapter However doing this will significantly increase driver ...

Page 36: ...r system saipconfig will configure the interfaces automatically When saipconfig has finished configuring the interfaces you will see this message You have selected the following configuration for adapter 1 Adapter Type 8 port PCI Async Intelligent Adapter Module Port Names 1 term a000 term a007 also dev cua axxx Interrupts disabled Is this configuration acceptable y or n Is this configuration acce...

Page 37: ...ystem The devices are named according to the following convention Note See Chapter 6 for more information about TTY device names TABLE 5 1 Format Used For Port Names Format Description dev term Directory path for dial in devices dev cua Directory path for dial out devices a z A Z Module letter ID 000 007 Port Number For example for the first board the module letter and port numbers will be a000 a0...

Page 38: ...e text output that can be redirected there is no other significance to date in this test If the date appears on the terminal screen the device is properly connected If the date does not appear on the terminal screen then that terminal is not receiving data check the power cables connections and so on If nonsense characters are printed on the terminal screen check the baud rates data bits stop bits...

Page 39: ...e 2 Using a text editor add this line to the end of the file that contained the MANPATH variable If neither of these files contain this variable add this line to the end of one of the files or contact your system administrator for assistance 3 Use the source command on the file you edited to make the changes effective in your current window For example if you added the MANPATH line to the login fi...

Page 40: ...ance 2 Make the changes effective in your current window 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 saipdl 7d sitty 1 spm 1m...

Page 41: ...ver and associated utilities will now be removed from the system In the event that some of the ports were open when pkgrm was initiated the unloading of the driver will fail In this case it will be necessary to reboot to complete the driver removal usr sbin pkgrm SUNWsaip SUNWsaipu This package contains scripts which will be executed with super user permission during the process of removing this p...

Page 42: ...28 SunSAI P User s Guide November 1998 ...

Page 43: ... user is greeted properly upon making a connection When used with a terminal or other device it is usually wise to wire the SunSAI P DCD signal to the terminal s DTR Data Terminal Ready line When the terminal is turned on the system outputs a login prompt When the terminal is turned off any associated jobs are killed and the user is logged out dev cua a000 Dial out TTY device This is the same as d...

Page 44: ...30 SunSAI P User s Guide November 1998 ...

Page 45: ...c rc2 d S99sittystuff refer to the Solaris System Administration Guide for details Alternatively you may include the sitty command sequence in your login or profile files Your system administrator can help you edit these files The full pathname for the command is opt SUNWconn bin sitty The format is With no options sitty displays all SunSAI P special driver settings modem signals and all standard ...

Page 46: ...For example 50 baud becomes 57 600 baud 75 baud becomes 76 800 baud and so on forcedcd Disable re enable carrier sense so the TTY may be opened and used even when carrier is not present altpin Switches the function of the DSR and the DCD inputs on the modular connector so that DCD is available when using an 8 pin RJ 11 connector instead of the 10 pin RJ 45 connector edelay n Sets the number n of m...

Page 47: ...ened stopout Stop output exactly as if an xoff character was received startout Restart stopped output exactly as if an xon character was received stopin Activate flow control to stop input startin Release flow control to resume stopped input dtr Raise drop the DTR modem control line unless DTR hardware flow control is selected rts Raise drop the RTS modem control line unless RTS hardware flow cont...

Page 48: ...34 SunSAI P User s Guide November 1998 ...

Page 49: ...he eight supported EIA 232 signals is displayed along with input and output flow control status SPM is installed automatically when you install this device driver and can be run from any terminal on the system Using SPM To run the Sun Port Manager enter the following command from any terminal or the system console The l logfile option specifies the file path for screen dumps If this option is not ...

Page 50: ...36 SunSAI P User s Guide November 1998 ...

Page 51: ...ly seated in the slot Potential hardware problem WARNING PCI SAI 8 No memory at 0xXX 4 What it means The driver cannot read the board s dual ported memory Action to take Make sure the board is fully seated in the slot Potential hardware problem WARNING PCI SAI 8 port X failed diagnostics 5 What it means The driver encountered an error executing on board BIOS Action to take Potential software probl...

Page 52: ... Can t get config info for PCI saip8 0 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 ...

Page 53: ...sions Length 6 875 inches Width 0 5 inches Height 4 2 inches Weight 6 1 ounces Operating Environment Ambient temperature 10 C to 55 C Relative humidity 5 to 90 Air movement 30 CFM forced Altitude 0 to 12 000 feet Serial Interface Surge Suppression Threshold Voltage TxD RxD 12 Volts Threshold Voltage Control Lines 12 Volts Response Time Less than 10 nS ...

Page 54: ...40 SunSAI P User s Guide November 1998 ...

Page 55: ... for detailed information about the SunVTS software These documents are available on the Solaris on Sun Hardware AnswerBook which can viewed on the Sun Documentation website http docs sun com The main features of the SunVTS environment include SunVTS kernel The SunVTS kernel vtsk controls all facets of the SunVTS environment When activated vtsk probes the hardware configuration of the system being...

Page 56: ... set user options start and stop tests and read log files 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 Note Some of the saiptest tests require a EIA 232 loopback plug which can be ordered through Sun part number 540 1558 ...

Page 57: ...gnments 5 illustrated 6 creating new devices 23 customer assistance 2 D DB 25 connector 6 chassis ground 6 pin assignments 5 declaration of conformity v device driver see software devices DTE 10 DTR 12 naming convention 23 tty names 29 diagnostic 41 dial in devices 23 29 dial out devices 23 29 directory structure 16 DTE devices connecting 10 DTR devices 12 E EIA 232 cables 6 connector pin assignme...

Page 58: ... ports enabling 24 numbers 23 power requirements 39 R rc script 18 ready busy hardware handshaking 12 rebooting the system 19 reconfiguration boot 19 regulatory compliance statements iii run control scripts 18 S saipconfig utility 18 saiptest diagnostic 41 serial interface surge suppression 39 shutdown command 19 sitty utility 18 31 options 32 software configuring 18 to 22 31 automatic 19 manual 2...

Page 59: ...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 U un installing software 27 ...

Page 60: ...46 SunSAI P User s Guide November 1998 ...

Reviews: