Perle Systems 5500152-23 User Manual

Page 1

UltraPort Serial Adaptors

User Guide
Part number: 5500152-23 Date: 19 November 2008
Navigating around this manual
Using this on-line manual. See page 5.
Contents. See page 8.
Index. See page 154.
Page 1
Page 2
Copyright statement This document must not be reproduced in any way whatsoever, either printed or
electronically, without the consent of: Perle Systems Limited
60 Renfrew Drive Markham, Ontario, Canada L3R 0E1
Perle reserves the right to make changes without further notice, to any products to improve reliability, function or design.
JETSTREAM, JETSTREAM4000, JETSTREAM8500 and LANSTREAM2000 are trademarks of Perle Systems Limited.
Microsoft, Windows 95, Windows 98, Windows NT, Windows 2000, Windows 2003 Server, Windows Vista, Windows Server 2008, and Internet Explorer are trademarks of Microsoft Corporation.
Netscape is a trademark of Netscape Communications Corporation. Solaris is a registered trademark of Sun Microsystems, Inc. in the USA and other countries. Perle Systems Limited, 19 November 2008.
Page 2
Page 3
FCC Note The products described in this manual have been found to comply with the limits for a Class
A digital device, pursuant to Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions in this Guide, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference, in which case the user will be required to correct the interference at his/her own expense.
EN 55022: 1998, Class A Note Warning: This is a Cla ss A product. In a domestic envir onment this product may cause radio
interference in which case the user may be required to take adequate measures. Caution: The products described in this manual are approved for co mmercial use only.
Page 3
Page 4
UltraPort Serial Adaptors User Guide

About this manual

Purpose of this manual

This manual tells you how to install, configure and use the Perle UltraPort, UltraPort SI, and UltraPort Express serial adaptor cards, cabling hardware, associated drivers and utilities.

Who this manual is for

This manual is aimed at users who want to add extra serial ports to their system using UltraPort serial adaptor cards. This manual requires a working knowledge of using personal computers and associated operating systems, as well as experience in installing host cards.
Warning Dangerous voltages exist inside computer systems. Before
installing host cards in your system, turn off the power supply and disconnect the power cord.
UltraPort Serial Adaptors User Guide Purpose of this manual
Page 4
Page 5

Using this on-line manual

The following is a brief guide to using this manual on-line.

Document navigation

This manual features document navigation hypertext buttons in the he ader are a as shown in the next picture:
Jump to Using this on-line manual
Jump to Index
Jump to Quick Reference
(if included)
Jump to previous location

Hypertext jumps

Jump to front of current chapter
Jump to Contents
Jump to Fast contents
You can also navigate around this manual by clicking on any cross reference or text in blue for example,
Hypertext jumps.
Note The Fast Contents, Contents and Index entries are all hypertext
jumps into this manual.
UltraPort Serial Adaptors User Guide Using this on-line manual
Page 5
Page 6

Revision history

Date Part number Description
June 2003 5500152-10 First issue of the UltraPort user manual. October 2003 5500152-11 Support for UltraPort2 and UltraPort8i adapter cards. February 2004 5500152-12 Updated the UltraPort for Linux installation. May 2004 5500152-13 Support for Linux 2.6 kernels. June 2004 5500152-14 Support for UltraPort SI adapter cards. November 2004 5500152-15 Support for Windows 95/98 on Ultraport SI adapter cards. March 2005 5500152-16 HD-68M Ultra SCSI has been changed to VHDCI-68 Ultra SCSI. August 2005 5500152-17 Made corrections to the VHDCI-68 Ultra SCSI pinout table. October 2005 5500152-18 Added support for SCO OpenServer 6. November 2005 5500152-19 Support for UltraPort Express adapter cards. August 2006 5500152-20 Updated Solaris installation instructions. February 2007 5500152-21 Added instructions for a new Windows 2000/XP/Server 2003/Vista
installation process. There are now three Windows drivers to support 32-bit,
64-bit x64, and 64-bit Itanium operating systems/processors. September 2008 5500152-22 Updated guide for Windows Server 2008 support. November 2008 5500152-23 Updated the instructions for installing the device drivers.
Page 6
Page 7
UltraPort Serial Adaptors User Guide

Fast Contents

ABOUT THIS MANUAL ........................................................... 4
REVISION HISTORY ............................................................... 6
FAST CONTENTS .................................................................. 7
CONTENTS ........................................................................... 8
CHAPTER 1 INTRODUCTION .................................................. 12
CHAPTER 2 INSTALLING DRIVERS AND HOST CARDS .............. 15
CHAPTER 3 CABLING INFORMATION ...................................... 101
APPENDIX A : TRANSPARENT PRINTING ................................ 128
APPENDIX B : OPERATIONS FOR EIA-422/EIA-485 .............. 132
APPENDIX C : TROUBLESHOOTING ........................................ 139
APPENDIX D : CONTACTING PERLE ...................................... 150
INDEX .................................................................................. 154
UltraPort Serial Adaptor User Guide
Page 7
Page 8
UltraPort Serial Adaptors User Guide

Contents

ABOUT THIS MANUAL ............................................................ 4
Purpose of this manual ..................................................................................4
Who this manual is for ...................................................................................4
Using this on-line manual ..............................................................................5
Document navigation................................................................................5
Hypertext jumps........................................................................................5
REVISION HISTORY ................................................................ 6
FAST CONTENTS................................................................... 7
CONTENTS............................................................................ 8
CHAPTER 1 INTRODUCTION 12
About the UltraPort, UltraPort SI, and UltraPort Express Serial
Adaptor cards ..................................................................................................13
Connection accessories ................................................................................14
CHAPTER 2 INSTALLING DRIVERS AND HOST CARDS 15
Before you start ...............................................................................................16
Downloading drivers from the Perle web site ...........................................17
Installing under Windows 95 and 98 ...........................................................18
General installation procedure for Windows 95 and 98............................19
Installing device drivers and utilities..........................................................20
Configuring serial ports.............................................................................24
Removing drivers and utilities from your system ......................................30
UltraPort Serial Adaptor User Guide
Page 8
Page 9
Installing under Windows NT .......................................................................32
Installing under Windows 2000/XP/Server 2003/Vista/Server 2008 .......33
General setup procedure for Windows 2000/XP/Server 2003/Vista/
Server 2008 ..............................................................................................34
Installing device drivers and utilities onto your system.............................35
Adding additional cards and/or updating drivers.......................................37
Configuring serial ports.............................................................................38
Installing under SCO OpenServer and OpenServer6 ..............................44
General installation procedure for SCO OpenServer................................45
Installing device drivers and utilities..........................................................46
Serial port naming conventions.................................................................51
Configuring serial ports.............................................................................52
Setultrap Interface Protocol Configuration Utility (UltraPort SI only).........57
Command Line Interface ...............................................................................57
Removing drivers and utilities from your system ......................................60
Installing under SCO UnixWare ...................................................................62
General installation procedure for SCO UnixWare...................................63
Installing drivers and utilities.....................................................................64
Serial port naming conventions.................................................................65
Configuring serial ports.............................................................................66
Setultrap Interface Protocol Configuration Utility (UltraPort SI only).........70
Command Line Interface ...............................................................................70
Removing drivers and utilities from your system ......................................73
Installing under Solaris ..................................................................................74
General installation procedure for Solaris.................................................75
Installing drivers and utilities.....................................................................76
Serial port naming conventions.................................................................77
Configuring serial ports.............................................................................78
Setultrap Interface Protocol Configuration Utility (UltraPort SI only).........82
Command Line Interface ...............................................................................82
Removing drivers and utilities from your system ......................................85
Installing under Linux .....................................................................................86
General installation procedure for Linux...................................................86
Installing Drivers onto your system...........................................................86
Uninstall Patch Versions ................................................................................87
Install from Source RPM ................................................................................88
Install from Tar File ........................................................................................ 88
Creating devices for the attached ports....................................................89
UltraPort 8i and UltraPort81 Express RTS/DTR option ............................90
UltraPort Serial Adaptor User Guide
Page 9
Page 10
Setultrap Interface Protocol Configuration Utility (UltraPort SI only).........90
Command Line Interface ...............................................................................91
Uninstalling the UltraPort Driver for Linux.................................................93
Installing host cards and cable accessories .............................................94
Installing UltraPort, UltraPort SI, and UltraPort Express cards.................95
Installing cables and connector boxes......................................................96
Installing cables on UltraPort1, UltraPort1 SI, UltraPort1 Express,
UltraPort2, and UltraPort2 SI cards ...............................................................97
Installing converter cables on UltraPort2 Express, UltraPort4,
UltraPort4 Express, and UltraPort4 SI-RJ45 cards .......................................97
Installing converter cables on UltraPort8i, and UltraPort81 Express cards ...97 Installing fan-out cables and connector boxes on UltraPort4 SI-LP, UltraPort4 Express HD, UltraPort 8 SI, UltraPort8, and UltraPort8 Express HD cards .. 98 Installing fan-out cables and connector boxes on UltraPort16 and
UltraPort16 SI cards ...................................................................................... 99
Removing host cards .....................................................................................100
CHAPTER 3 CABLING INFORMATION 101
Definitions of Signals and Direction ............................................................102
Host card back panel connectors and pinouts .........................................103
DB9 back panel connectors and pinout....................................................104
RJ45 back panel connectors and pinout...................................................105
UltraPort4 SI-RJ45 Switches ....................................................................106
RJ12 back panel connectors and pinout...................................................107
VHDCI-68 Ultra SCSI back panel connectors and pinout.........................108
Connector box and cable guide ...................................................................1 15
Connector box and cable pinouts ...............................................................1 17
RJ45 10-pin to DB25 converter.................................................................118
RJ45 10-pin to DB9 converter...................................................................119
RJ45 10-pin to RJ45 SPEED converter....................................................120
RJ45 10-pin to RJ45 Digi converter..........................................................121
RJ45 10-pin to RJ45 Digi ALTPIN converter.............................................122
RJ45 connector box..................................................................................123
DB25 connector box .................................................................................124
DB9 connector box ...................................................................................125
DB25 Fan-out cable..................................................................................126
DB9 Fan-out cable....................................................................................127
UltraPort Serial Adaptor User Guide
Page 10
Page 11
APPENDIX A : TRANSPARENT PRINTING 128
What is transparent printing?....................................................................129
Problems with printer output.....................................................................130
The printcap.spd configuration file............................................................130
The print.spd configuration file..................................................................131
APPENDIX B : OPERATIONS FOR EIA-422/EIA-485 132
The EIA-422 Standard .....................................................................................133
The EIA-485 Standard .....................................................................................134
Cabling Distances ...........................................................................................138
APPENDIX C : TROUBLESHOOTING 139
SCO OpenServer 5 ..........................................................................................140
Example of normal SPEED driver boot messages ...................................140
Additional card warning messages...........................................................141
SCO OpenServer 5 error messages.........................................................142
SCO UnixWare/SCO OpenServer 6 .............................................................143
Additional card warning messages...........................................................144
SCO UnixWare error messages ..............................................................145
Windows NT .....................................................................................................147
Windows NT general troubleshooting UltraPort and UltraPort SI only......147
Windows 2000/XP/Server 2003/Vista/Server 2008 ....................................148
General troubleshooting under Windows 2000/XP/Server 2003/Vista/
Server 2008 ..............................................................................................149
Windows error messages .........................................................................149
APPENDIX D : CONTACTING PERLE 150
Making a technical support query ...............................................................150
Who to contact..........................................................................................150
Information needed when making a query................................................151
Making a support query via the Perle web page.......................................152
Repair procedure ............................................................................................152
Feedback about this manual ........................................................................152
Perle support centres worldwide .................................................................153
INDEX ................................................................................... 154
UltraPort Serial Adaptor User Guide
Page 11
Page 12
UltraPort Serial Adaptors User Guide

Chapter 1 Introduction

You need to read this chapter if you want to...
You need to read this chapter if you want an introduction to the Perle UltraPort, UltraPort SI, and UltraPort Express serial adaptor cards, driver software and configuration utilities.
This chapter includes the following sections:
About the UltraPort, UltraPort SI, and UltraPort Express Serial Adaptor cards on page 13
Connection accessories on page 14
UltraPort Serial Adaptors User Guide
Chapter 1 Introduction
Page 12
Page 13

About the UltraPort, UltraPort SI, and UltraPort Express Serial Adaptor cards

The UltraPort Serial Adaptor cards are multi-port cards which provide extra serial ports for EIA-232, EIA-422 and EIA-485 peripherals. These cards plu g into your PC servers and provide 1,2, 4, 8 or 16 high speed ports suitable for remote access, data collection, point of sale or any other EIA-232, EIA-422, or EIA-485 applications.
You use the UltraPort, UltraPort SI, and UltraPort Express serial adaptor cards when you want a robust entry level solution for the small office or point of sale applications. Typically you use UltraPort, UltraPort SI, and UltraPort Express serial adaptor cards because you want to add extra serial ports to an existing computer system rather than replacing it with the considerable cost that entails. Higher data rates and ESD protection in the UltraPort, UltraPort SI, and UltraPort Express serial adaptor cards make it suitable for any modem or ISDN TA application.
Note To use the Ul t raP o r t, UltraPort SI, or UltraPort Express serial adaptor cards you must first
install the card, and then install the dr ivers supplied with the card. You can now configure each card as required prior to mechanical installation. The installation procedu re varies for different operating systems. Please read
Installing drivers and host cards befor e commencing installa tion.
Before you start on page 16 in Chapter 2
UltraPort Serial Adaptors User Guide About the UltraPort, UltraPort SI, and UltraPort Express Serial Adaptor cards
Page 13
Chapter 1 Introduction
Page 14

Connection accessories

The connector box or cable required for the UltraPort p roducts you are using depend s on the number of ports and product type. For details see
Chapter 3 Cabling information
UltraPort Serial Adaptors User Guide Connection accessories
Chapter 1 Introduction
Page 14
Page 15
UltraPort Serial Adaptors User Guide

Chapter 2 Installing drivers and host cards

You need to read this chapter if you want to...
You need to read this chapter if you want to install UltraPort, UltraPort SI, and UltraPort Express serial adaptor cards, associated hardware and software.
This chapter provides information about inst alling and configuring UltraPort, UltraPort SI, and UltraPort Express serial adaptor cards.
Note The procedure for installing and config uring UltraPort serial adaptor cards varies for dif ferent
operating systems. Please read installation.
This chapter includes the following sections:
Before you start on page 16
Downloading drivers from the Perle web site on page 17
Installing under Windows 95 and 98 on page 18
Installing under Windows NT on page 32
Installing under Windows 2000/XP/Server 2003/Vista/Server 2008 on page 33
Installing under SCO OpenServer and OpenServer6 on page 44
Installing under SCO UnixWare on page 62
Before you start on page 16 before commencing
Installing under Solaris on page 74
Installing under Linux on page 86
Installing host cards and cable accessories on page 94
Removing host cards on page 100.
UltraPort Serial Adaptors User Guide
Chapter 2 Installing drivers and host cards
Page 15
Page 16

Before you start

Before you install your UltraPort, UltraPort SI, and UltraPort Express host cards and software, note that the procedure for installing and configuring UltraPort and UltraPort SI, UltraPort Express serial adaptor cards varies for different operating systems.
To install under a particular operating system, please refer to one of the operating system specific installation procedures listed below:
Installing under Windows 95 and 98 on page 18
Installing under Windows NT on page 32
Installing under Windows 2000/XP/Server 2003/Vista/Server 2008 on page 33
Installing under SCO OpenServer and OpenServer6 on page 44
Installing under SCO UnixWare on page 62
Installing under Solaris on page 74
Installing under Linux on page 86
UltraPort Serial Adaptors User Guide Before you start
Chapter 2 Installing drivers and host cards
Page 16
Page 17

Downloading drivers from the Perle web site

You can install the UltraPort driver and utility software from the Perle web site. To do this proceed as follows:
1. On your PC, start the Internet browser you want to use.
2. Within your Internet browser window, select the software directory using the following URL:
http://www.perle.com/downloads
Note In the event of any problems contact your System Administrator or
Internet Service provider for assistance.
3. Change to the software directory. The software directory is now displayed.
4. Download the zip files in this directory to a suitable location on your PC for example, /tmp.
5. Uncompress the files using a suitable utility.
6. You can now install the driver software using the correct procedure for your operating system. See
Before you start on page 16.
UltraPort Serial Adaptors User Guide Downloading drivers from the Perle web site
Chapter 2 Installing drivers and host cards
Page 17
Page 18

Installing under Windows 95 and 98

This section tells you how to install UltraPort and UltraPort SI only host cards, software drivers and utilities under the Windows 95 and Windows 98 operating systems and includes the following:
General installation procedure for Windows 95 and 98 on page 19
Installing device drivers and utilities on page 20
Configuring serial ports on page 24
Removing drivers and utilities from your system on page 30.
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 18
Page 19

General installation procedure for Windows 95 and 98

The general procedure for installing UltraPort and UltraPort SI only cards under the Windows 95/98 operating systems is as follows:
1. Install any UltraPort and UltraPort SI cards and cables or connector boxes you require into your system. See
2. Using the Windows Found New Hardware Wizard, install the UltraPort or UltraPort SI device driver software. See
Note The UltraPort and UltraPort SI device drivers for Windows 95/98 are
not included on your Windows 95 or Windows 98 CDROM.
3. If required, remove any host cards you want from your system. See Removing host
cards on page 100.
4. Using the Windows Device Manager, configure the serial ports you have added to the system. See
Configuring serial ports on page 24.
Installing host cards and cable accessories on page 94.
Installing device drivers and utilities on page 20
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 19
Page 20

Installing device drivers and utilities

To install or enable the UltraPort and UltraPort SI device drivers on your system pr oc ee d as follows:
1. Turn on your PC and if required, log in. If you have installed any new UltraPort or UltraPort SI cards, a Found New Hardware -
“PCI Serial Controller” message is briefly shown followed by the Add New Hardware Wizard window as shown below:
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 20
Page 21
2. Proceed by clicking Next and the following Add New Hardware Wizard window will appear:
3. Proceed again by clicking Next and the following Add New Hardware Wizard window will appear
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 21
Page 22
4. Inset the Perle CD and check the Specify a location check box. Now either browse to, or type in the following path d:\driversultraport\win9x\x.yy. Where x.yy is the windows 95/ 98 driver version number. Then click Next and the following Add New Hardware Wizard window will appear:
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 22
Page 23
5. Proceed by clicking Next and the final Add New Hardware Wizard window will appear as below:
6. Proceed by clicking Finish. Windows will now copy all the files needed for the device driver. After the driver installation is complete, the driver will automatically find all of the serial ports associated with the UltraPort or UltraPort SI card . A se ries of New Hardware Found messages will be temporarily displayed for every port found.
Installation of the device drivers and utilities is now complete.
Note:
Your system does not need to be restarted to start using the newly added serial ports
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 23
Page 24

Configuring serial ports

To configure UltraPort or UltraPort SI serial ports proceed as follows:
1. In the windows desktop, click on the Start button and select Settings > Control panel. The control panel window is now displayed.
2. In the control panel window, double click on the System icon. The System Properties tabbed window is displayed.
Hint Y ou can also displ ay the System Properties tabbed window by right
clicking on the My Computer icon on your desktop and selecting the Properties menu option.
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 24
Page 25
3. In the System Properties tabbed window, click on the Device Manager tab. The Device Manager page is now displayed.
4. In the Device Manager page, double click on the device whose properties you wish to view.
The properties tabbed window for the selected device is now displayed.
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 25
Page 26
5. In the properties window, click on the Port Settings tab. The Settings page is now displayed.
6. In the Port Settings page, select the configuration values you want and either click on the OK button or click on the FIFO Settings tab to display FIFO configuration settings for the device driver.
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 26
Page 27
7. The FIFO Settings page is now displayed as shown in the next picture
Selects the port name for a given device.
Allows you to select the default port name or change it to any unused port name.
Default display is the currently assigned port name.
8. In the FIFO Settings page, select the configuration values you want and either click on the
OK button or, if the COM port belongs to a UltraPort SI card, then you can click on the Protocol Settings tab to access the software switchable interface modes.
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
In
Caution It is strongly recommended that you do not make changes to the
FIFO trigger levels or com port name unless you have a va lid reason to do so.
Chapter 2 Installing drivers and host cards
Page 27
Page 28
9. The Protocol Settings page is now displayed as shown in the next picture
10.In the Protocol Settings page, select the configuration values you want and click on the OK button.
Re-configuration of ports is now complete.
Protocol T ype: The valid software switchable protocol types are EIA-232, EIA-422, EIA-485 Full Duplex and EIA-485 Half Duplex. Each port on the Ultra Port SI are independent of each other and therefore you may select different protocols per serial port.
Baud Rate Multiplier: The baud rate multiplier allows the user to multiply the configured baud rate by 1, 2, 4, 8,16 or 32, hence achieving greater speeds on the UltraPort SI serial interfaces. This is applicable for each protocol type selected. Baud rates for EIA-232 are up to 921.6 Kbps per serial port. Baud rates for EIA-422/EIA-485 are up to 3.686 Mbps per serial port.
Slew Rate Limiting: The default setting for slew rate limiting is disabled. This will allow higher baud rate speeds on each EIA interface port. Slew rate limiting enabled, minimizes EMI and reduces reflections caused by improperly terminated cables. Operation in slew rate limited mode reduces the amplitudes of high-frequency harmonics.
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 28
Page 29
Line Termination: The line termination parameter is not changeable by the user in EIA-232 mode. However both EIA-422 and EIA-485 modes are defaulted to disabled but can be enabled by the user if needed.
EIA-485 HDX Local Echo: Local echo by default is on. This parameter applies only to EIA-485 half duplex mode. All characters will be echoed to the user and transmitted across the serial ports. Some EIA-485 applications require local echo to be enable in or der to monitor the loopba ck data to determine that line contention has occurred. If your application cannot handle loopback data the local echo should be disabled.
EIA-485 TX Driver Control: The default for this field is AUTO. When Auto is set the UltraPort SI will automatically detect the beginning and the ending of data being tra nsmitted in order to enable and disable the transmit line. When the field is set to RTS it is the host app lication’s responsibility to enable and disable the transmit line via the RTS handshake line when it wants to send data.
Auto EIA-485 Bit Delay: By default this field is set to 0 delay. This fiel d is only applicable if you have configured EIA-485 TX Driver Control to AUTO. Values for this field are 0 through 15 bit s.
Note The port must be closed and then opened for the new parameters to
take effect.
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 29
Page 30

Removing drivers and utilities from your system

To remove drivers and utilities from your system proceed as follows:
1. In the windows desktop, click on the Start button and select Settings > Control panel. The control panel window is now displayed.
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Chapter 2 Installing drivers and host cards
Page 30
Page 31
2. In the control panel window, double click on the System icon. The System Properties tabbed window is now displayed as shown in the next picture.
3. In the System Properties tabbed window, click on the Device Manager tab The Device Manager page is now displayed.
4. In the Device Manager page, click on the Perle Multi-function adapter that you wish to remove, highlighting it then press the Remove button.
The selected device is now removed from the system.
UltraPort Serial Adaptors User Guide Installing under Windows 95 and 98
Warning If you remove the devices but do not remove the hardware, the
devices will be re-installed when you next re-boot the machine or run the Hardware Wizard.
Chapter 2 Installing drivers and host cards
Page 31
Page 32

Installing under Windows NT

The procedure for installing and configuring host cards, drivers software and associated utilities for the Windows NT operating system is as follows:
Note The Perle PortDirector software contains drivers for the UltraPort and UltraPort SI host
cards only . Y ou will need to inst all the PortDirector for Windows NT on your system in order to use
the UltraPort and UltraPort SI host cards. See the PortDirector user guide part number 5500028 for further details.
1. Install any UltraPort and UltraPort SI cards, cables or connector boxes you require into your system. See
2. If required, remove any host cards you want from your system. See Removing host
cards on page 100.
3. Use the PortDirector software to update your system with the revised number an d type of host cards. See The PortDirector user guide part number 5500028 for further details.
Your system can now use the serial adaptor cards you have installed.
Installing host cards and cable accessories on page 94.
UltraPort Serial Adaptors User Guide Installing under Windows NT
Chapter 2 Installing drivers and host cards
Page 32
Page 33

Installing under Windows 2000/XP/Server 2003/Vista/ Server 2008

This section describes how to install the UltraPort, Ultra Port SI, an d UltraPort Expr ess driver software under Microsoft Windows 2000, XP, Server 2003, Vista, or Server 2008.
This section includes the following:
General setup procedure for Windows 2000/XP/Server 2003/Vista/Server 2008 on page 34
Installing device drivers and utilities onto your system on page 35
Adding additional cards and/or updating drivers on page 37
Configuring serial ports on page 38
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 33
Page 34

General setup procedure for Windows 2000/XP/Server 2003/Vista/Server 2008

The general procedure for installing UltraPort, UltraPort SI, and UltraPort Express cards under the Windows 2000, XP, Server 2003, Vista, or Server 2008 operating systems is as follows:
1. Install any UltraPort and cards and cables or connector boxes you require into your system. See
2. Install the UltraPort, UltraPort SI, or UltraPort EXPRESS device driver software. See
Installing device drivers and utilities onto your system on page 35.
3. If you add new UltraPort, UltraPort SI, and UltraPort Express cards, you should run Update Driver to make sure the new cards have the latest driver . See
cards and/or updating drivers on page 37.
4. If required, remove any host cards you want from your system. See Removing host
cards on page 100.
5. Using the Windows Device Manager, configure the serial ports you have added to the system. See
Installing host cards and cable accessories on page 94.
Adding additional
Configuring serial ports on page 38.
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 34
Page 35

Installing device drivers and utilities onto your system

To install or enable the UltraPort, UltraPort SI, and UltraPort Express device drivers on your system, proceed as follows:
1. Turn on your PC and, if required, log in. If you have installed any new UltraPort cards, a Found New Hardware message is briefly
shown followed by the Found New Hardware wizard as shown below.
2. In the Found New Hardware wizard, click the Cancel button.
3. Download the lastest UltraPort/UltraPort SI/UltraPort Express driver file from the Perle website for your operating system:
pserial-x86.exe for 32-bit Windows operating system s pserial-amd64.exe for 64-bit Windows operating systems pserial-ia64.exe for 64-bit Windows Itanium oper ating systems
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 35
Page 36
4. Double-click the installation executable that you downloaded in step 3, and follow the installation wizard steps:
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 36
Page 37
5. During the installation, you may get a Windows Logo message. Click Continue Anyway when the message appears.
Note If you are installing an unsigned dr iver , you may h ave to click through the Found New
Hardware wizard for every UltraPort port on your system.
Your UltraPort/UltraPort SI/UltraPort Express driver installation is now finished.

Adding additional cards and/or updating drivers

Whenever you add any additional UltraPort, UltraPort SI, or UltraPort Express hardware to your system, Windows might install the latest digitally signed driver in its database (depending on your Windows operating system and settings). To ensure you have the latest driver installed after you add new hardware, you ca n either:
Click Start > All Programs > Perle > Perle-Serial > Update Driver or
Reinstall the drivers as described in Installing device drivers and utilities onto your
system on page 35.
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 37
Page 38

Configuring serial ports

To configure UltraPort and UltraPort SI and UltraPort Express serial ports under Windows 2000, XP, Server 2003, Vista, or Server 2008 proceed as follows:
1. In the Windows desktop, click on the Start button and select Settings > Control Panel The control panel window is now displayed.
2. In the Control Panel window, click on the System icon. The System Properties tabbed window is now displayed.
3. In the System Properties window, click on the Hardware tab. The hardware page is now displayed.
4. In the Hardware page, click on the Device Manager Button. The Device Manager window is now displayed.
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 38
Page 39
5. In the Device Manager window, click on the Multiport serial adapters icon to display the currently installed devices.
6. In the Device Manager window, double click on the device whose properties you want to view or change
The device Properties tabbed window is now displayed.
7. In the device Properties window, click on the Port Settings tab to display the Port Settings page.
8. In the Port Settings page, set the Port Number, Baud Rate and other configuration parameters you require.
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 39
Page 40
9. If the COM port belongs to a UltraPort SI card then yo u can click on the Advanced button to access the software switchable interface modes as shown in the next diagram.
Protocol T ype: The valid software switchable protocol types are EIA-232, EIA-422, EIA-485 Full Duplex and EIA-485 Half Duplex. Each port on the Ultra Port SI are independent of each other and therefore you may select different protocols per serial port.
Baud Rate Multiplier: The baud rate multiplier allows the user to multiply the configured baud rate by 1, 2, 4, 8,16 or 32, hence achieving greater speeds on the UltraPort SI serial interfaces. This is applicable for each protocol type selected. Baud rates for EIA-232 are up to 921.6 Kbps per serial port. Baud rates for EIA-422/EIA-485 are up to 3.686 Mbps per serial port.
Slew Rate Limiting: The default setting for slew rate limiting is disabled. This will allow higher baud rate speeds on each EIA interface port. Slew rate limiting enabled, minimizes EMI and reduces reflections caused by improperly terminated cables. Operation in slew rate limited mode reduces the amplitudes of high-frequency harmonics.
Line Termination: The line termination parameter is not changeable by the user in EIA-232 mode. However both EIA-422 and EIA-485 modes are defaulted to disabled but can be enabled by the user if needed.
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 40
Page 41
EIA-485 HDX Local Echo: Local echo by default is on. This parameter applies only to EIA-485 half duplex mode. All characters will be echoed to the user and transmitted across the serial ports. Some EIA-485 applications require local echo to be enable in or der to monitor the loopba ck data to determine that line contention has occurred. If your application cannot handle loopback data the local echo should be disabled.
EIA-485 TX Driver Control: The default for this field is AUTO. When Auto is set the UltraPort SI will automatically detect the beginning and the ending of data being tra nsmitted in order to enable and disable the transmit line. When the field is set to RTS it is the host app lication’s responsibility to enable and disable the transmit line via the RTS handshake line when it wants to send data.
Auto EIA-485 Bit Delay: By default this field is set to 0 delay. This fiel d is only applicable if you have configured EIA-485 TX Driver Control to AUTO. Values for this field are 0 through 15 bit s.
Note The port must be closed and then opened for the new parameters to
take effect.
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 41
Page 42
In the FIFO Settings page, set the FIFO buffer levels using the parameters detailed in the table.
.
Parameter Description Tx FIFO Limit Sets the overall size of the Transmit FIFO buffer .You use this
Tx FIFO Trigger Level Sets the level at which the com port T ransmit FIFO bu ffer is
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
when you want to restrict the size of the buffer in order to control the data flow . This is useful when your ap plication requires you to send small amounts of data but needs acknowledge ment that the data has been sent.
For example, if your application is designed to receive 4 bytes at a time, a larger value of say 16 would time out.
Permitted values for an UltraPort card are 1 to 64.
filled with data each time a request for more data is made. For example, if set to 16 bytes you get 16 bytes at a time when
driver requests data. Permitted values for an UltraPort card are 8, 16, 32 and 56.
Chapter 2 Installing drivers and host cards
Page 42
Page 43
Parameter Description Rx FIFO Trigger Level Sets the level at which the com port Receive FIFO buf fer is filled
before the data is passed on to an application. For example, if set to 16 bytes, 16 bytes of data are
accumulated at a time before data is passed on to an application. The FIFO trigger will also time out if the level is not achieved within two character periods of the last byte received.
Permitted values for an UltraPort card are 8, 16, 56 and 60.
High Flow Control Threshold
Sets the level at which data flow is suspended. If the limit is exceeded, the driver will stop collecting data.
For UltraPort, value is read only, set automatically from FIFO trigger level.
Low Flow Control Threshold
Sets the level at which data flow is resumed. If the low flow threshold is exceeded, the driver requests more
data. For UltraPort, value is read only, set automatically from FIFO trigger level.
10.Within the Serial Port properties window, click on the OK button to save changes and close the window.
The configuration process is now complete.
Hint To restore the default settings, use the Restore Defaults button.
UltraPort Serial Adaptors User Guide Installing under Windows 2000/XP/Server 2003/Vista/Server 2008
Chapter 2 Installing drivers and host cards
Page 43
Page 44

Installing under SCO OpenServer and OpenServer6

This section tells you how to install host cards, software drivers and utilities under the SCO OpenServer operating system and includ es the follow ing :
General installation procedure for SCO OpenServer on page 45
Installing device drivers and utilities on page 46
Serial port naming conventions on page 51
Configuring serial ports on page 52
Removing drivers and utilities from your system on page 60.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 44
Page 45

General installation procedure for SCO OpenServer

The general procedure for installing and configuring host cards, drivers software and associated utilities for the SCO OpenServer operating system is as follows:
1. Install any UltraPort, UltraPort SI, and UltraPort Express cards you require into your system. See
2. Install the SPEED SCO OpenServer drivers and utilities onto your system using the procedures described in
3. If required, remove any host cards you want from your system. See Removing host
cards on page 100.
4. Using the Port Configuration tool, configure the serial ports you have added to the system. See
Your system can now use the serial adaptor cards you have installed. If required, you can reconfigure serial ports following initial installation.
Installing host cards and cable accessories on page 94
Installing device drivers and utilities on page 46.
Configuring serial ports on page 52.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 45
Page 46

Installing device drivers and utilities

To install the SPEED device drivers and utilities for the SCO OpenServer operating system proceed as follows:
1. Login to your system as super user.
2. Load the CDROM into your system CD drive.
3. At the command prompt, make a directory for your installation by typing:
mkdir /cdrom
4. Mount the CDROM file system using the following commands: mount -f ISO9660 -r/dev/cd0 /cdrom
Note The example above shows the directory name as /cdrom, You can either use this
name or use another directory name to suit your requirements. For example, /mnt.
5. In the SCO OpenServer desktop, double click on the System Administration folder. The System Administration window is now displayed.
6. In the System Administration window, double click on the software manager icon. The Software Manager window is now displayed.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 46
Page 47
7. In the Software Manager menu, click on Software > Install New. The Begin Installation window is now displayed as shown in the next picture.
Click here to select the local host as the host machine.
8. In the Begin Installation window, select the local host as the machine to install from by clicking on the From localhostname button and then click on Continue.
The Select Media window is now displayed.
9. In the Select Media window, using the Media Device selector choose the Media Images option then click on Continue.
The Enter Image Directory window is now displayed.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 47
Page 48
10.In the Enter Image Directory window, enter the following in the Image directory field: /cdrom/drivers/ultraport/openserver/x.y.z, where x.y.z is the version number of the
driver for SCO OpenServer 5. /cdrom/drivers/ultraport/openserver6/x.y.z, where x.y.z is the version number of the
driver for SCO OpenServer 6.
Note The example and picture above show a directory name including /cdrom, You can
either include this name in the path or use another directory name to suit your requirements. For example, /mnt.
11.In the Enter Image Directory window, click on OK. The Install Selection window is now displayed.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 48
Page 49
12.In the Install Selection window, click on the Install button. The following progress message is now displayed.
The above window will display various progress messages and then the Speed Installation Options window will be displayed.
13.If required, in the Speed Installation Options window, select the Re-Link kernel option.
Hint If you are installing more then one driver, you can de-select this option until you
have installed all the drivers and utiliti es you require to save time.
14.In the Speed Window Installation menu, click on Options > Exit to close the window and continue the installation process.
If you select Re-link kernel, a message window is displayed at the end of the driver installation prompting you to re-boot the system.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 49
Page 50
15.In the message window click on OK to continue the installation process. The following message is now displayed upon completion of the installation process.
16.In the message window, click on OK to close the window. The software manager window is now updated to show the driver you have installed as
shown in the next picture.
17.In the Software Manager window, click on the Host > Exit menu option to close the window.
18.Shut down your system and turn the power off.
You can now continue with the rest of the installation process see General installation
procedure for SCO OpenServer on page 45.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 50
Page 51

Serial port naming conventions

Each serial port has three device nodes associated with it. Each no de t akes the form of a file which you can access from operating system utilities and user applications. Details of these nodes are shown in the next table.
Device name Function Description Location
ttyz1 Normal communications port
ttyZ1 Modem port Indicates that a port open will
ttyz1p Transparen t print port. Indicates that device should
for local “tty” devices.
Indicates normal communications port behaviour .
not complete unless DCD is present
only be used for transparent print.
/dev
/dev
/dev
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 51
Page 52

Configuring serial ports

The Port Configuration utility allows you to configure the SPEED serial ports you have installed on your system. To do this proceed as follows:
Note If you want to perform transparent printing from an y of the terminals attached to yo ur
system, you need to check the contents of the printcap.spd file to see if the terminal type you are using is supported. To do this proceed as follows:
1. Using a text editor , go to the /etc directory and open the file called
2. Check the contents of the printcap.spd file to see if the terminal type you are
3. If the terminal type you are using is not supported, add an entry for the new
You can now configure the ports you want using the Port Configuration utility.
printcap.spd
using is supported. See
page 12 8 in Appendix A : Transparent printing for
the syntax of the entries in this file.
terminal type (including the type, transparent print ON and transparent print OFF strings) to the printcap.spd file (
page 130). See the user guide for your
terminal for details of the entries required.
Starting the Port Configuration utility
1. In the command prompt, type spdpcfg and press the Enter key. Alternatively use the SCO OpenServer desktop as follows:
a. In the SCO OpenServer desktop, open the System Administration folder.
The System Administration window is now displayed.
b. In the System Administration window, click on the Perle Speed folder on
OpenServer 5 or Perle-Serial folder for OpenServer 6 to open it. The Speed window is now displayed.
c. In the Speed window, click on the Speed Port Configuration Icon.
The Port Configuration window is now displayed as shown in the next picture.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 52
Page 53
Menus see
page 53.
Select one or more ports from this list.
Select a getty definition here. See page 54.
Enables or disables login. See page 55
Menu map The Port Configuration tool menu is as follows:
Menu option Description
Ports > Quit Qui t Port Configuration to ol without saving
changes.
Logins Display all ports with logins enabled. Unconfigured Display all ports without logins enabled. All Display all ports. Save & Exit Exit the Port Configuration tool and save
changes.
Select a terminal type here. See page 55
Enables or disables flow control. See page 55
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 53
Page 54
Selecting ports 2. In the Port Configuration window, select the ports you want you want to configure by
clicking on one or more items in the list of ports (example in next picture).
Hint T o select multiple items which follow each other in the list, hold down the Shift key and click
on all the items you want. T o select multiple items from anywhere in the list, hold down the Ctrl key and click on all the
items you want.
Selecting a getty definition
3. In the Port Configuration window, select the getty definition you want by double clicking on an item in the Available gettydefs list. Alternatively, click on the Set button.
The list of currently selected ports is now updated to show the new getty definition.
New definition displayed here
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 54
Page 55
Selecting terminal type
4. In the Terminal type list, double click on the terminal type you want for the currently selected ports. Alternatively , single click on the item you want in the Terminal type list and press the Set button.
The list of ports is now updated to show the new terminal type.
New terminal type displayed here
Enabling and disabling flow control
Setting up a port login
5. If required, in the Port Configuration window, click on the ixon button to enable flow control for Transparent printing.
Note For information about transparent printing, see Appendix A : Transparent printing.
6. If required, in the Port Configuration window, click on the ixany button to enable sending of data on receipt of the next character (when flow control is enabled on the transparent print port).
7. In the Port Configuration window , click on one of the menu options shown in the next table to display the ports with the login status you want to change. For example, ports without logins enabled.
These options allow you to filter on the type of ports you are looking for. This facility is helpful when you have a large number of ports installed.
T o Display Click menu option
All ports with logins enabled Ports > Logins All ports without logins enabled Ports > Unconfigured Display all ports Ports > All
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 55
Page 56
Exiting the Port Configuration tool
8. If required, in the Port Configuration window, select the ports whose logins status you want to change, then click on one of the following to change the login status:
Tc Click on
Enable logins for a port Enable button Disable logins for a port Disable button
The selected ports in the list now are updated show their new login status. For example if you enable the login for a port, a tick is displayed along sid e the port as shown in the next picture.
9. Repeat steps 2. to 8. until you have configured all the ports you want.
10.In the Port Configuration menu, click on Ports > Save & Exit.
Note To quit the Port Configuration tool without saving changes,
In the Port Configuration menu, click on Ports > Quit.
The Port Configuration tool now closes and saves any changes you have made.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 56
Page 57

Setultrap Interface Protocol Configuration Utility (UltraPort SI only)

Perle provides a command line utility that allows the user to configure each UltraPort SI serial ports for features EIA-232, EIA-422, EIA-485 full duplex and EIA-485 half duplex.
Note The default interface protocol for the Perle UltraPort SI cards is EIA-232.
Command Line Interface
setultrap -f device_name -l setultrap -f device_name -x baud-multiplier setultrap -f device_name -m 232 [-s fast|slow] setultrap -f device_name -m 422 [-s fast|slow] [-t term|unterm] setultrap -f device_name -m 485fdx [-s fast|slow] [-t term|unterm] [-a auto|rts] [-b 0-15] setultrap -f device_name -m 485hdx [-s fast|slow] [-t term|unterm] [-e echoon|echooff]
[-a auto|rts] [-b 0- 15]
-l list protocol configuration for serial device(s)
-x set baudrate multiplier for serial devices(s)
-m set interface protocol for serial device(s )
Configuration
Option description
specifies the port to
option
232 422 485hdx 485fdx
-f required required required required apply the configuration option to
Lists the serial ports
-l optional optional optional optional configuration
Interface mode -m default
232
optional 422
optional 485hdx
optional 485fdx
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 57
Page 58
Configuration
Option description
option
232 422 485hdx 485fdx
Baud rate multiplier -x optional
(1,2,4,8, 16,32)
Slew rate limiting -s optional
fast/slow
optional (1,2,4,8, 16,32) optional fast/slow
optional (1,2,4,8, 16,32) optional fast/slow
optional (1,2,4,8, 16,32) optional fast/slow
Line termination -t N/A optional
(term/ unterm)
EIA-485 HDX local
-e N/A N/A optional echo
optional (term/
unterm)
echoon/
optional (term/
unterm) N/A
echoff
EIA-485 TX Driver Control
Auto EIA-485 bit delay -b N/A N/A optional
-a N/A N/A optional
(auto/rts)
( 0 -15)
optional (auto/rts) optional ( 0 -15)
(-f) Specifies the name or range of names which the action should be taken on. For example:
/dev/ttyz1 -specifies port 1 /dev/ttyz1,/dev/ttyz64 - specifies ports 1 through 64 (-l) Lists the protocol configuration for each seria l port configured on the Ultr aPort SI. /dev/ttyz1 232 slow term 1 /dev/ttyz1 485fdx fast term auto 5 1 The first example shows a device named ttyz1 configured for protocol mode EIA-232, slew rate
limiting is set to slow, termination is on, and the baud rate multiplier is 1 The second example shows device named ttyz1 configure d for protocol mode EIA-4 85fdx, slew rate
limiting is set to fast, termination is on, EIA-485 HDX TX Driver Control is set to auto with bit delay of 5 bits and the baud rate multiplier is 1
(- m ) Interface mode: The valid software switchable protocol types are EIA-232, EIA-422, EIA-485 Full Duplex and EIA-485 Half Duplex. Each port on the Ultr aPort SI are independen t of each other and therefore you may select different protocols per serial port.
(-x) Baud Rate Multiplier: The baud rate multiplier allows the user to multiply the configured baud rate by 1, 2, 4, 8,16 or 32, hence achieving greater speeds on the UltraPort SI serial interfaces. This is applicable for each protocol type selected. Baud rates for EIA-232 are up to 921.6 Kbps per serial port. Baud rates for EIA-422/EIA-485 are up to 3.686 Mbps per serial port.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 58
Page 59
(-s) Slew Rate Limiting: The default setting for slew rate limiting is fast. This will allow higher baud rate speeds on each EIA interface port. Slew rate limiting enabled, minimizes EMI and reduces reflections caused by improperly terminated cables. Operation in slew rate limited mode reduces the amplitudes of high-frequency harmonics.
(-t) Line Termination: The line termination parameter is not changeable by the user in EIA­232 mode. However both EIA-422 and EIA-485 modes are defaulted to terminated but can be changed by the user if needed.
(-e) EIA-485 HDX Local Echo: Local echo by default is set to echoon. This parameter applies only to EIA-485 half duplex mode. All characters will be echoed to the user and transmitted across the serial ports. Some EIA-485 applications require local echo to be enable in order to monitor the loopback data to determine that line contention has occurred. If your application cannot handle loopback data the local echo should be set to echoof f.
(-a) EIA-485 TX Driver Control: The default for this field is auto. When auto is set the UltraPort SI will automatically detect the beginning and the ending of data being tra nsmitted in order to enable and disable the transmit line. When the field is set to rts it is the host application’ s responsibility to enable and disable the transmit line via the RTS handshake line when it wants to send data.
(-b) Auto EIA-485 Bit Delay: By default this field is set to 0 delay. This field is only applicable if you have configured EIA-485 TX Driver Control to AUTO. Values for this field are 0 through 15 bi ts.
(-h) Help: Displays the setultrap usage screen.
The following examples show typical user applications: etc/setultrap -f /dev/ttyz1,/dev/ttyz16 -l -lists options configured for serial ports 1 through 16. etc/setultrap -f /dev/ttyz1,/dev/ttyz16 -m 422 -sets serial port 1 through 16 to interface type
EIA-422 etc/setultrap -f /dev/ttyz1,/dev/ttyz4 -m 485fdx -configures ports 1 to 4 to EIA-485 full duplex etc/setultrap -f /dev/ttyz1 -m 485hdx -t term -b 5 -sets serial port ttyz1 to EIA-485 half duplex
termination enabled, control bit-delay 5 These commands may be added to a startup script to cause them to run automatically
whenever the system is started. A sample commented out startup script (etc/rc.setultrap) is supplied with this driver.
Note The port must be closed and then opened for the new parameters to take effect.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 59
Page 60

Removing drivers and utilities from your system

To remove the SPEED device drivers and utilities for the SCO OpenServer operating system proceed as follows:
1. In the SCO OpenServer desktop, double click on the System Administration folder. The System Administration window is now displayed.
2. In the System Administration window, double click on the software manager icon. The Software Manager window is now displayed.
3. In the Software Manager window select the driver you want to remove.
4. In the Software Manager menu, click on Software > Remove software. A confirmation window is now displayed prompting you to confirm rem o va l.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 60
Page 61
5. In the confirmation window, click on the Remove button. The software is now removed and the following Kernel re-link message is now displayed
as shown in the next picture (not displayed under SCO OpenServer 6).
The Kernel re-link message window now closes and the removal continue s. A message is displayed upon completion.
6. In the message window , click on OK to close the window. The software manager window is now updated to show the remaining software.
UltraPort Serial Adaptors User Guide Installing under SCO OpenServer and OpenServer6
Chapter 2 Installing drivers and host cards
Page 61
Page 62

Installing under SCO UnixWare

This section tells you how to install host cards, software drivers and utilities under the SCO UnixWare operating system and includes the following:
General installation procedure for SCO UnixWare on page 63
Installing drivers and utilities on page 64
Serial port naming conventions on page 65
Configuring serial ports on page 66
Installing under Solaris on page 74.
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 62
Page 63

General installation procedure for SCO UnixWare

The general procedure for installing and configuring host cards, drivers software and associated utilities for the SCO UnixWare operating system is as follows:
1. Install any UltraPort cards you require into your system. See Installing host cards and
cable accessories on page 94
Note Once you have installed the SPEED drivers, if you add or remov e any ho st card s the
operating system will update the kernel accordingly using the spdconf program. spdconf is run automatically during boot up and checks to see if any host cards have
been added or removed since the last time the system was powered up. If anything has changed the files which identify the ports, terminals and transparent printing are updated.
2. If required, install the SPEED SCO UnixWare drivers and utilities onto your system using the procedures described in
3. If required, remove any host cards you want from your system. See Removing host
cards on page 100.
4. Using the Serial Manager utility, configure the serial ports you have added to the system. See
Configuring serial ports on page 66.
Installing drivers and utilities on page 64.
Your system can now use the serial adaptor cards you have installed. If required, you can reconfigure serial ports following initial installation.
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 63
Page 64

Installing drivers and utilities

To install the SPEED device drivers and utilities for the SCO UnixWare operating system proceed as follows:
1. Login to your system as root.
2. Load the CDROM into your system CD drive.
3. Mount the CDROM to a mount point, for example /cdrom.
4. At the command prompt, type: pkgadd -d /cdrom/drivers/ultraport/unixware/x.y.z/spd-uw-x.y.z.pkg spd , where x.y. z is the version number of the driver.
5. Press the Enter key. The system now installs the driver and displays a series of messages ending with a
successful installation message.
Upon installation of the drivers, your UltraPort cards are ready to use.
Note A re-boot of your system is not necessary as the drivers for your UltraPort card are
dynamically loadable and will be loaded as soon as any software attempts to access the associated devices.
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 64
Page 65

Serial port naming conventions

Each serial port has three device nodes associated with it. Each no de t akes the form of a file which you can access from operating system utilities and user applications. Details of these nodes are shown in the next table.
Device name Function Description Location
z1 Normal communications port
Z1 Modem port Indicates that a port open will
z1p Transparen t print port. Indicates that device should
for local “tty” devices.
Indicates normal communications port behaviour .
not complete unless DCD is present
only be used for transparent print.
/dev/term
/dev/term
/dev/term
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 65
Page 66

Configuring serial ports

The software provided with the SCO UnixWare operating system includes a utility called Serial Manager which allows you to configure the extra serial ports you have added to your system.
Note On UnixWare 7.0, you must apply a p atch file called ptf7053 before using the Serial Manager.
Y ou can find the patch on the SCO web site at:
http://www.sco.com
To configure serial ports with Serial Manager pr oceed as follows:
Note If you want to perform transparent printing from an y of the terminals attached to yo ur
system, you need to check the contents of the printcap.spd file to see if the terminal type you are using is supported. To do this proceed as follows:
1. Using a text editor , go to the /etc directory and open the file called
2. Check the contents of the printcap.spd file to see if the terminal type you are
printcap.spd
using is supported. See
page 13 0 in Appendix A : Transparent printing for
the syntax of the entries in this file.
3. If the terminal type you are using is not supported, add an entry for the new terminal type (including the type, transparent print ON and transparent print OFF strings) to the printcap.spd file (
page 130). See the user guide for your
terminal for details of the entries required.
4. If you have made any changes then type spdconf in or der to re-configure the print port settings.
You can now configure the ports you want using the Serial Manager utility.
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 66
Page 67
1. At the command prompt, type scoadmin The System Administration window is now displayed as shown in the next picture.
2. In the System Administration tool window, click on the Hardware folder and then select
Serial Manager
The Serial Manager window is now displayed showing the host cards (including SPEED) currently present on the system.
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 67
Page 68
3. In the Serial Manager window, select the host card you want. Then in the Serial Manager menu, click on View > P orts.
The Serial Manager window now displays the ports available for the selected host card as shown in the next picture.
4. In the Serial Manager menu, click on Port-U > Modify. The Modify Serial Port window is now displayed.
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 68
Page 69
5. In the Modify Serial Port window, set the parameters shown in the next table
Parameter Set to
Port Type Select either Local T erminal or Modem Configure port incoming only Speed the speed value you require
Note Because the system does not support the selection of speeds above
115200
bps, lower baud rates have been permanently remapped to support
higher port speeds. Remapped speeds are shown in the next table.
Selected speed (bp s) Actual speed (bps)
50 230400 75 460800 110 921600
6. In the Modify Serial Port window, click on the Port settings button. The Port settings window is now displayed.
7. In the Port settings window, select the Data bits and Parity values you require and click on OK.
8. In the Modify Serial Port window, click on OK to accept the changes you have made and close the window.
9. Repeat steps 3. to 8. until you have configured the serial ports for all the host cards you require.
10.In the Serial Manager menu click on Host > Quit to quit Serial Manager and close the window.
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 69
Page 70

Setultrap Interface Protocol Configuration Utility (UltraPort SI only)

Perle provides a command line utility that allows the user to configure each UltraPort SI serial port individually for EIA-232, EIA-422, EIA-485 full duplex or EIA-485 half duplex prototcol.taken.
Note The default interface protocol for the Perle UltraPort SI cards is EIA-232.
Command Line Interface
setultrap -f device_name -l setultrap -f device_name -x baud-multiplier setultrap -f device_name -m 232 [-s fast|slow] setultrap -f device_name -m 422 [-s fast|slow] [-t term|unterm] setultrap -f device_name -m 485fdx [-s fast|slow] [-t term|unterm] [-a auto|rts] [-b 0-15] setultrap -f device_name -m 485hdx [-s fast|slow] [-t term|unterm] [-e echoon|echooff]
[-a auto|rts] [-b 0- 15]
-l list protocol configuration for serial device(s)
-x set baudrate multiplier for serial devices(s)
-m set interface protocol for serial device(s )
:
Configuration
Option description
specifies the port to
option
232 422 485hdx 485fdx
-f required required required required apply the configuration option to
Lists the serial ports
-l optional optional optional optional configuration
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 70
Page 71
Configuration
Option description
option
232 422 485hdx 485fdx
Interface mode -m default
232
Baud rate multiplier -x optional
(1,2,4,8, 16,32)
Slew rate limiting -s optional
fast/slow
optional 422 optional (1,2,4,8, 16,32) optional fast/slow
optional 485hdx optional (1,2,4,8, 16,32) optional fast/slow
optional 485fdx optional (1,2,4,8, 16,32) optional fast/slow
Line termination -t N/A optional
(term/ unterm)
EIA-485 HDX local
-e N/A N/A optional echo
optional (term/
unterm)
echoon/
optional (term/
unterm) N/A
echoff
EIA-485 TX Driver Control
Auto EIA-485 bit delay -b N/A N/A optional
-a N/A N/A optional
(auto/rts)
( 0 -15)
optional (auto/rts) optional ( 0 -15)
(-f) Specifies name or range of names of the tty device on which the action should be taken. For example: /dev/term/z1 -specifies port 1 /dev//term/z1,/dev/term/z64 -specifies ports 1 through 64 (ranges are separated by a
comma) (-l) Lists the protocol configuration for each serial port configured on the UltraPort SI. /dev/term/z1 232 slow term 1 /dev/term/z1 485fdx fast term auto 5 1 The first example shows a device named z1 configured for protocol mode EIA-232, slew rate limiting
is set to slow, termination is on, and the baud rate multiplier is 1 The second example shows device named z1 configured for proto col mode EIA-485fdx, slew rate
limiting is set to fast, termination is on, EIA-485 HDX TX Driver Control is set to auto with bit delay of 5 bits and the baud rate multiplier is 1
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 71
Page 72
(- m ) Interface mode: The valid software switchable protocol types are EIA-232, EIA-422, EIA-485 Full Duplex and EIA-485 Half Duplex. Each port on the Ultr aPort SI are independen t of each other and therefore you may select different protocols per serial port.
(-x) Baud Rate multiplier: The baud rate multiplier allows the user to multiply the configured baud rate by 1, 2, 4, 8,16 or 32, hence achieving greater speeds on the UltraPort SI serial interfaces. This is applicable for each protocol type selected. Baud rates for EIA-232 are up to 921.6 Kbps per serial port. Baud rates for EIA-422/EIA-485 are up to 3.686 Mbps per serial port.
(-s) Slew Rate Limiting: The default setting for slew rate limiting is fast. This will allow higher baud rate speeds on each EIA interface port. Slew rate limiting enabled, minimizes EMI and reduces reflections caused by improperly terminated cables. Operation in slew rate limited mode reduces the amplitudes of high-frequency harmonics.
(-t) Line Termination: The line termination parameter is not changeable by the user in EIA­232 mode. However both EIA-422 and EIA-485 modes are defaulted to terminated but can be changed by the user if needed.
(-e) EIA-485 HDX Local Echo: Local echo by default is echoon. This parameter applies only to EIA­485 half duplex mode. All characters will be echoed to the user and transmitted across the se rial ports. Some EIA-485 applications require local echo to be enable in order to monitor the loopback data to determine that line contention has occurred. If your application cannot handle loopback data the local echo should be set to echoof f.
(-a) EIA-485 TX Driver Control: The default for this field is auto. When auto is set the UltraPort SI will automatically detect the beginning and the ending of data being tra nsmitted in order to enable and disable the transmit line. When the field is set to rts it is the host application’ s responsibility to enable and disable the transmit line via the RTS handshake line when it wants to send data.
(-b) Auto EIA-485 Bit Delay: By default this field is set to 0 delay. This field is only applicable if you have configured EIA-485 TX Driver Control to AUTO. Values for this field are 0 through 15 bi ts.
(-h) Help: Displays the setultrap usage screen.
The following examples show typical user applications: etc/setultrap -f /dev/term/z1,/dev/term/z16 -l -lists options configured for serial ports 1
through 16 etc/setultrap -f /dev/term/z1,/dev/term/z16 -m 422 -sets mode EIA-422 for serial port 1
through 16 etc/setultrap -f /dev/term/z1,/dev/term/z4 -m 485fdx -configures serial ports 1 to 4 to EIA-485
full duplex
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Note The port must be closed and then opened for the new parameters to
take effect.
Chapter 2 Installing drivers and host cards
Page 72
Page 73
etc/setultrap -f /dev/term/z1 -m 485hdx -t term -b 5 -sets serial port z1 to EIA-485 half duplex, termination enabled, control bit-delay 5.
These commands may be added to a startup script to cause them to run automatically whenever the system is started. A sample commented out startup script supplied with this driver.

Removing drivers and utilities from your system

To remove the software driver s from your system under the SCO UnixW are ope rating system proceed as follows:
1. At the command prompt, type pkgrm spd and press Enter The SPEED driver and associated utilities are now removed from your system.
(/etc/rc.setulrap) is
UltraPort Serial Adaptors User Guide Installing under SCO UnixWare
Chapter 2 Installing drivers and host cards
Page 73
Page 74

Installing under Solaris

This section tells you how to install host cards, software drivers and utilities under the Solaris operating system and includes the following:
General installation procedure for Solaris on page 75
Installing drivers and utilities on page 76
Serial port naming conventions on page 77
Configuring serial ports on page 78
Removing drivers and utilities from your system on page 85.
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 74
Page 75

General installation procedure for Solaris

The general procedure for installing and configuring host cards, drivers software and associated utilities for the Solaris operating system is as follows:
1. Install any UltraPort cards you require into your system. See Installing host cards and
cable accessories on page 94
Note Once you have installed the drivers, if you add or remove any host cards the operating
system will update the kernel accordingly using the startcomf program. startcomf is run automatically during boot up and checks to see if any host cards have
been added or removed since the last time the system was powered up. If anything has changed the files which identify the ports and terminals are updated.
2. If required, install the Solaris drivers and utilities onto your system using the procedures described in
3. If required, remove any host cards you want from your system. See Removing host
cards on page 100.
4. Using the admintool utility, configure the serial ports you have added to the system. See
Configuring serial ports on page 78.
Installing drivers and utilities on page 76.
Your system can now use the serial adaptor cards you have installed. If required, you can reconfigure serial ports following initial installation.
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 75
Page 76

Installing drivers and utilities

To install the device drivers and utilities for the Solaris operating system proceed as follows:
1. Login to your system as root.
2. Load the CDROM into your system CD drive.
3. Mount the CDROM to a mount point, for example /cdrom.
4. At the command prompt, type: pkgadd -d /cdrom/drivers/ultraport/solaris/x.y.z/fast-sol-x.y.z.<arch>.pkg comf, where x.y.z is the version number of the driver and <arch> is the Solaris architecture, either i386 for Intel or sparc for Sparc stations.
5. Press the Enter key. The system now installs the driver and displays a series of messages ending with a
successful installation message.
Upon installation of the drivers, your UltraPort cards are ready to use.
Note A re-boot of your system is not necessary as the drivers for your UltraPort card are
dynamically loadable and will be loaded as soon as any software attempts to access the associated devices.
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 76
Page 77

Serial port naming conventions

By default, each port is associated with three entries under the /dev directory. Two t ake the form /dev/comfxy and /dev/term/co mfxy where x is the car d number (1-4) and y
is a lower case letter in the range a-p. a is port 1, ..., p is port 16. These device names are intended for local devices.
The third device name takes the form /dev/cua/comf xy where x is the card number and y is a lower case letter in the range a-p, as before. These devices are intended for use with modems.
These mappings can be altered by careful modification of the mkdev and startcomf scripts in /usr/lib/comf/i86.
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 77
Page 78

Configuring serial ports

The software provided with the Solaris operating system includes a utility called admintool which allows you to configure the extra serial ports you have added to your system.
To configure serial ports with admintool proceed as follows:
1. At the command prompt, type admintool The Admintool: Users window is now displayed as shown in the next picture.
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 78
Page 79
2. In the Admintool: Users window, click on Browse > Serial Ports. The Admintool: Serial Ports window is now displayed showing all serial ports currently
present on the system
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 79
Page 80
3. .In the Admintool: Serial Ports window, select the port you want to configure. To configure the port, click on Edit > Modify.
The Admintool: Modify Serial Port window is now displayed.
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 80
Page 81
In the Admintool: Modify Serial Port window you can click on the Expert bu tton to show more fields, as shown in the next picture.
4. In the Admintool: Modify Serial Port window, set the parameters you require.
Note Because the system does not support the selection of speeds above
460800 higher port speeds. Remapped speeds are shown in the next table.
5. In the Admintool: Modify Serial Port window, click on OK to accept the changes you have made and close the window.
6. Repeat steps 3. to 5. until you have configured the serial ports for all the host cards you require.
7. In the Serial Manager menu click on Host > Quit to quit Serial Manager and close the window.
UltraPort Serial Adaptors User Guide Installing under Solaris
bps, lower baud rates have been permanently remapped to support
Selected speed (bp s) Actual speed (bps)
50 921600
Chapter 2 Installing drivers and host cards
Page 81
Page 82

Setultrap Interface Protocol Configuration Utility (UltraPort SI only)

Perle provides a command line utility that allows the user to configure each UltraPort SI serial ports for features EIA-232, EIA-422, EIA-485 full duplex and EIA-485 half duplex.
Note The default interface protocol for the Perle UltraPort SI cards is EIA-232.
Command Line Interface
setultrap -f device_name -l setultrap -f device_name -x baud-multiplier setultrap -f device_name -m 232 [-s fast|slow] setultrap -f device_name -m 422 [-s fast|slow] [-t term|unterm] setultrap -f device_name -m 485fdx [-s fast|slow] [-t term|unterm] [-a auto|rts] [-b 0-15] setultrap -f device_name -m 485hdx [-s fast|slow] [-t term|unterm] [-e echoon|echooff]
[-a auto|rts] [-b 0- 15]
-l list protocol configuration for serial device(s)
-x set baudrate multiplier for serial devices(s)
-m set interface protocol for serial device(s ):
Configuration
Option description
specifies the port to
option
232 422 485hdx 485fdx
-f required required required required apply the configuration option to
Lists the serial ports
-l optional optional optional optional configuration
Interface mode -m default
232
optional 422
optional 485hdx
optional 485fdx
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 82
Page 83
Configuration
Option description
option
232 422 485hdx 485fdx
Baud rate multiplier -x optional
(1,2,4,8, 16,32)
Slew rate limiting -s optional
fast/slow
optional (1,2,4,8, 16,32) optional fast/slow
optional (1,2,4,8, 16,32) optional fast/slow
optional (1,2,4,8, 16,32) optional fast/slow
Line termination -t N/A optional
(term/ unterm)
EIA-485 HDX local
-e N/A N/A optional echo
optional (term/
unterm)
echoon/
optional (term/
unterm) N/A
echoff
EIA-485 TX Driver Control
Auto EIA-485 bit delay -b N/A N/A optional
-a N/A N/A optional
(auto/rts)
( 0 -15)
optional (auto/rts) optional ( 0 -15)
(-f) Specifies the name or range of names in which the action should be taken on. /term/comf1a -specifies port 1 on card 1 /term/comf2a,/term/comf2p - specifies ports 1 through 16 to interface type EIA-422 on card 2 (-l) Lists protocol configuration for each serial port configured on the UltraPort SI. /dev/term/comf1a 232 slow term 1 /dev/term/comf1a 485fdx fast term auto 5 1 The first example shows a device named comf1a configured for protocol mode EIA-232, slew rate
limiting is set to slow, termination is on, and the baud rate multiplier is 1 The second example shows device named comf1a configur ed for protocol mode EIA-48 5fdx, slew
rate limiting is set to fast, termination is on, EIA-485 HDX TX Driver Control is set to auto with bit delay of 5 bits and the baud rate multiplier is 1
(- m ) Interface mode: The valid software switchable protocol types are EIA-232, EIA-422, EIA-485 Full Duplex and EIA-485 Half Duplex. Each port on the Ultr aPort SI are independen t of each other and therefore you may select different protocols per serial port.
(-x) Baud Rate multiplier: The baud rate multiplier allows the user to multiply the configured baud rate by 1, 2, 4, 8,16 or 32, hence achieving greater speeds on the UltraPort SI serial interfaces. This is applicable for each protocol type selected. Baud rates for EIA-232 are up to 921.6 Kbps per serial port. Baud rates for EIA-422/EIA-485 are up to 3.686 Mbps per serial port.
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 83
Page 84
(-s) Slew Rate Limiting: The default setting for slew rate limiting is fast. This will allow higher baud rate speeds on each EIA interface port. Slew rate limiting enabled, minimizes EMI and reduces reflections caused by improperly terminated cables. Operation in slew rate limited mode reduces the amplitudes of high-frequency harmonics.
(-t) Line Termination: The line termination parameter is not changeable by the user in EIA­232 mode. However both EIA-422 and EIA-485 modes are defaulted to terminated but can be changed by the user if needed.
(-e) EIA-485 HDX Local Echo: Local echo by default is echoon. This parameter applies only to EIA­485 half duplex mode. All characters will be echoed to the user and transmitted across the se rial ports. Some EIA-485 applications require local echo to be enable in order to monitor the loopback data to determine that line contention has occurred. If your application cannot handle loopback data the local echo should be set to echoof f.
(-a) EIA-485 TX Driver Control: The default for this field is auto. When auto is set the UltraPort SI will automatically detect the beginning and the ending of data being tra nsmitted in order to enable and disable the transmit line. When the field is set to rts it is the host application’ s responsibility to enable and disable the transmit line via the RTS handshake line when it wants to send data.
(-b) Auto EIA-485 Bit Delay: By default this field is set to 0 delay. This field is only applicable if you have configured EIA-485 TX Driver Control to auto. Values for this field are 0 through 15 bits.
(-h) Help: Displays the setultrap usage screen.
Note The port must be closed and then opened for the new parameters to
take effect.
The following examples show typical user applications: etc/setultrap -f /dev/term/comf1a,/dev/term/comf1p -l -lists options configured for serial ports
1 through 16. etc/setultrap -f /dev/term/comf1a,/dev/term/comf1p -m 422 -sets serial port 1 through 16 to
interface type EIA-422 etc/setultrap -f /dev/term/comf1a,/dev/term/comf1d -m 485fdx -configures ports 1 to 4 to EIA-
485 full duplex etc/setultrap -f /dev/term/comf1a -m 485hdx -t term -b 5 -sets serial port comf1a to EIA-485
half duplex termination enabled, control bit-delay 5 The commands may be added to a startup script or put at the end of the /etc/inittab file, to
cause them to run automatically whenever the system is started. A sample commented out startup script /etc/init.setultrap is supplied with this driver.
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 84
Page 85

Removing drivers and utilities from your system

To remove the software drivers from your system under the Solaris operating system proceed as follows:
1. At the command prompt, type pkgrm comf and press Enter The driver and associated utilities are now removed from your system.
UltraPort Serial Adaptors User Guide Installing under Solaris
Chapter 2 Installing drivers and host cards
Page 85
Page 86

Installing under Linux

This section tells you how to install host cards, software drivers and utilities under the Linux operating system and includes the following:
General installation procedure for Linux on page 86
Installing Drivers onto your system on page 86
Creating devices for the attached ports on page 89
•.UltraPort 8i and UltraPort81 Express RTS/DTR option on page 90
Setultrap Interface Protocol Configuration Utility (UltraPort SI only) on page 90

General installation procedure for Linux

The general procedure for installing and configuring host cards, driver software and associated utilities for the Linux operating system is as follows:
1. Install any UltraPort cards you require into your system. See Installing host cards and
cable accessories on page 94.
2. Install the UltraPort Linux drivers onto your system using the procedures described in
Installing Drivers onto your system on page 86.
3. Create devices for the required ports using the procedures detailed in Creating devices
for the attached ports on page 89.
Your system can now use the UltraPort serial adaptor cards you have installed.

Installing Drivers onto your system

The UltraPort cards and UltraPort SIinstalled on Li nux machines use the perle-serial driver for Linux. The driver supports the Linux kernel versions 2.2, 2.4 and 2.6. The kernel header files are needed for kernel 2.2 and 2.4. For the 2.6 kernel, a configuration kernel source tree and a set of makefile rules describing how the modules are built is required.
The UltraPort Express cards installed on Linux machines use the perle-serial driver for L inux. The driver supports the Linux kernel versions 2.4 and 2.6. The Kernel header files are needed for kernel 2.4. For the 2.6 kernel, a configuration kernel source tree and a set of makefile rules describing how the modules are build is required
The driver is supplied in both source RPM package format and a comp ressed tar file. The procedure for installation of each format is as follows:
UltraPort Serial Adaptors User Guide Installing under Linux
Chapter 2 Installing drivers and host cards
Page 86
Page 87
Uninstall Patch Versions
The Perle-Serial driver version 2.0 and higher is a standalone kernel module. If previous patches have been made to the kernel for the UltraPort card, then these patches must be uninstalled before the new driver module can be installed.
1. Find the UltraPort patch files to the kernel. Remove the patches from the kernel source files by entering the following commands:
2. Recompile and install the kernel based on your specific system. For help on this procedure please refer to your LINUX documentation.
3. The new Perle-Serial software can now be installed
cd /usr/src/linux patch –R –p1 < <path to patches>/<patch file>
Note: If more than one patc h file was added, then remove the m in the reverse order that they were applied. (i.e. If the ultraport.patch-x.y.z-2.4.x was added and then the ultraport.IO8mode-x.y.z-2.4.x was added, remove the ultraport.IO8mode patch first.)
UltraPort Serial Adaptors User Guide Installing under Linux
Chapter 2 Installing drivers and host cards
Page 87
Page 88
Install from Source RPM
1. Log in to the LINUX system as root user.
2. At the LINUX prompt, copy the supplied perle-serial-<version>-<release>.src.rpm file onto your system in the /tmp directory.
3. Install the source rpm by typing the following command:
4. Build the binary RPM package for your system by entering the following commands:
5. Install the binary RPM which was just created. Enter the following commands:
Notes:
The <packages directory> path name in the following instructions will be different depending on the LINUX distribution you have installed. ( i.e. Redhat will have a “redhat” directory; Suse will have a “packages” directory)
The <rpm build command> will change depending on the version of the RPM utilities installed. For newer versions (i.e. 4.2) , the <rpm build command> is “rpmbuild”. For older versions use “rpm”.
rpm –ivh perle-serial-<version>-<release>.src.rpm
cd /usr/src/<packages directory>/SPECS <rpm build command> -bb perle-serial-<version>.spec
Install from Tar File
cd /usr/src/<packages directory>/RPMS/<arch> rpm –ivh perle-serial-<version>-<release>.<arch>.rpm
The <arch> value is the architecture of your LINUX machine such as “i386” or “alpha”.
1. Log in to the LINUX system as root user.
2. At the LINUX prompt, copy the supplied perle-serial .tgz file onto your system in the /tmp directory.
3. Unpack the file using the command:
tar –xzvf perle-serial-<version>-<release>.tgz
4. Build and install the perle-serial software by entering the following commands
cd /tmp/perle-serial-<version>-<release> ./tar_install.sh
UltraPort Serial Adaptors User Guide Installing under Linux
Chapter 2 Installing drivers and host cards
Page 88
Page 89

Creating devices for the attached ports

After the UltraPort cards and the new driver have been installed, terminal devices will need to be created for the added ports. This can be done be using the ps_addports utility.
To use the ps_addports script, enter the following command:
ps_addports m n
where:
m is the first port device (starting at 0) n is the last port device to add.
The port devices will be created in the /dev directory and will have the following format:
/dev/ttyPSnn where nn is the 2 digit port number. The perle-serial driver has been installed so that it will automatically be loaded the first time
an UltraPort device is used. However, if more than one UltraPort card has been installed in the Linux machine, then the driver can be manually loaded to determine which terminal device numbers have been assigned to each card.
To load the driver, enter the command:
modprobe perle-serial
Review the messages in the file /var/log/messages. Once the port devices have been created, they m ay be used as st andar d LINUX seria l TTYs.
UltraPort Serial Adaptors User Guide Installing under Linux
Chapter 2 Installing drivers and host cards
Page 89
Page 90

UltraPort 8i and UltraPort81 Express RTS/DTR option

The Perle UltraPort8i and Ultraport81 Express can only support eith er R TS or DT R. There is a utility included with this driver to configure which signal will be active. The configuration is stored in the modules.conf file.
The utility is used as follows:
set_io8_rts off
This is the default action. The driver will use the pin as "DTR" when the tty is in soft-
ware handshake mode.
set_io8_rts on
If this option is used or hardware handshake is on, the pin will always be RTS.
Note The perle serial module will have to be unloaded and reloaded for the
RTS/CTS option to take effect.

Setultrap Interface Protocol Configuration Utility (UltraPort SI only)

Perle provides a command line utility that allows the user to configure each UltraPort SI serial ports for features EIA-232, EIA-422, EIA-485 full duplex and EIA-485 half duplex.
Note The default interface protocol for the Perle UltraPort SI cards is EIA-232.
UltraPort Serial Adaptors User Guide Installing under Linux
Chapter 2 Installing drivers and host cards
Page 90
Page 91
Command Line Interface
setultrap -f device_name -l setultrap -f device_name -x baud-multiplier setultrap -f device_name -m 232 [-s fast|slow] setultrap -f device_name -m 422 [-s fast|slow] [-t term|unterm] setultrap -f device_name -m 485fdx [-s fast|slow] [-t term|unterm] [-a auto|rts] [-b 0-15] setultrap -f device_name -m 485hdx [-s fast|slow] [-t term|unterm] [-e echoon|echooff]
[-a auto|rts] [-b 0- 15]
-l list protocol configuration for serial device(s)
-x set baudrate multiplier for serial devices(s)
-m set interface protocol for serial device(s )
:
Configuration
Option description
specifies the port to
option
232 422 485hdx 485fdx
-f required required required required apply the configuration option to
Lists the serial ports
-l optional optional optional optional configuration
Interface mode -m default
232
Baud rate multiplier -x optional
(1,2,4,8, 16,32)
Slew rate limiting -s optional
fast/slow
optional 422 optional (1,2,4,8, 16,32) optional fast/slow
Line termination -t N/A optional
(term/ unterm)
optional 485hdx optional (1,2,4,8, 16,32) optional fast/slow
optional (term/
unterm)
optional 485fdx optional (1,2,4,8, 16,32) optional fast/slow
optional (term/
unterm)
UltraPort Serial Adaptors User Guide Installing under Linux
Chapter 2 Installing drivers and host cards
Page 91
Page 92
Configuration
Option description
EIA-485 HDX local echo
option
232 422 485hdx 485fdx
-e N/A N/A optional
echoon/
N/A
echoff
EIA-485 TX Driver Control
Auto EIA-485 bit delay -b N/A N/A optional
-a N/A N/A optional
(auto/rts)
( 0 -15)
optional (auto/rts) optional ( 0 -15)
(-f) Specifies the port the action should be taken on. /dev/ttyPS1 - specifies port 1 /dev/ttyPS1,/dev/ttyPS64 -specifies po rt 1 thro ug h por t 64 (r an ge s ar e separate d by a
comma) (-l) Lists protocol configuration for each serial port configured on the UltraPort SI. /dev/ttyPS1 232 slow term 1 /dev/ttyPS1 485fdx fast term auto 5 1 The first example shows a device named ttyPS1 configured for protocol mode EIA-232, slew rate
limiting is set to slow, termination is on, and the baud rate multiplier is 1 The second example shows device named ttyPS1 configur ed for protocol mode EIA-485fdx, slew
rate limiting is set to fast, termination is on, EIA-485 HDX TX Driver Control is set to auto with bit delay of 5 bits and the baud rate multiplier is 1
(- m ) Interface mode: The valid software switchable protocol types are EIA-232, EIA-422, EIA-485 Full Duplex and EIA-485 Half Duplex. Each port on the Ultr aPort SI are independen t of each other and therefore you may select different protocols per serial port.
(-x) Baud Rate multiplier: The baud rate multiplier allows the user to multiply the configured baud rate by 1, 2, 4, 8,16 or 32, hence achieving greater speeds on the UltraPort SI serial interfaces. This is applicable for each protocol type selected. Baud rates for EIA-232 are up to 921.6 Kbps per serial port. Baud rates for EIA-422/EIA-485 are up to 3.686 Mbps per serial port.
(-s) Slew Rate Limiting: The default setting for slew rate limiting is disabled. This will allow higher baud rate speeds on each EIA interface port. Slew rate limiting enabled, minimizes EMI and reduces reflections caused by improperly terminated cables. Operation in slew rate limited mode reduces the amplitudes of high-frequency harmonics.
(-t) Line Termination: The line termination parameter is not changeable by the user in EIA­232 mode. However both EIA-422 and EIA-485 modes are defaulted to disabled but can be enabled by the user if needed.
UltraPort Serial Adaptors User Guide Installing under Linux
Chapter 2 Installing drivers and host cards
Page 92
Page 93
(-e) EIA-485 HDX Local Echo: Local echo by default is on. This parameter applies only to EIA-485 half duplex mode. All characters will be echoed to the user and transmitted across the serial ports. Some EIA-485 applications require local echo to be enable in order to monitor the loopback data to determine that line contention has occurred. If your application cannot handle loopback data the local echo should be disabled.
(-a) EIA-485 TX Driver Control: The default for this field is AUTO. When Auto is set the UltraPort SI will automatically detect the beginning and the ending of data being transmitted in order to enable and disable the transmit line. When the field is set to RTS it is the host app lication’s responsibility to enable and disable the transmit line via the RTS handshake line when it wants to send data.
(-b) Auto EIA-485 Bit Delay: By default this field is set to 0 delay. This field is only applicable if you have configured EIA-485 TX Driver Control to AUTO. Values for this field are 0 through 15 bi ts.
(-h) Help: Displays the setultrap usage screen.
Note The port must be closed and then opened for the new parameters to
take effect.
The following examples show typical user applications: etc/setultrap -f /dev/ttyPS0,/dev/ttyPS15- l -lists options configured for serial ports 1 through
16 etc/setultrap -f /dev/ttyPS0,/dev/ttyPS15 -m 422 -sets serial port 1 through 16 to interface
type EIA-422 etc/setultrap -f /dev/ttyPS0,/dev/ttyPS3 -m 485fdx -configures ports 1 to 4 to EIA-485 full
duplex etc/setultrap -f /dev/ttyPS1 -m 485hdx -t term -b 5 -sets serial port ttyPS1 to EIA-485 half
duplex termination enabled, control bit-delay 5 These commands may be added to a startup script to cause them to run automatically
whenever the system is started. A sample commented out startup script is rc.setultrap)
supplied with this driver.

Uninstalling the UltraPort Driver for Linux

To uninstall the driver enter the following command:
rpm -e perle-serial
(/etc/init.d/
UltraPort Serial Adaptors User Guide Installing under Linux
Chapter 2 Installing drivers and host cards
Page 93
Page 94

Installing host cards and cable accessories

This section describes the mechanical installation of the UltraPort or UltraPort SI host cards and associated connector boxes and cables for 1,2, 4, 8 and 16 ports and includes the following:
Installing UltraPort, UltraPort SI, and UltraPort Express cards on page 95
Installing cables and connector boxes on page 96
UltraPort Serial Adaptors User Guide Installing host cards and cable accessories
Chapter 2 Installing drivers and host cards
Page 94
Page 95

Installing UltraPort, UltraPort SI, and UltraPort Express cards

This section describes the mechanical installation of UltraPort cards. To install an UltraPort host card proceed as follows:
Note The exact location of host card slots varies for different systems, for exact mechanical
details of your system, refer to your system documentation.
Warning Dangerous voltages exist inside computer systems. Before
installing host cards in your system, turn off the power supply and unplug the power cord.
1. Turn off the power to your system and unplug the power cord.
2. Remove the system cover to expose the inside of the connector panel for host cards.
3. Insert the UltraPort card you want to install into a vacant host PCI /PCI Express card slot and secure in place as shown in the next picture.
Caution Full anti-static precau tions should be t aken when handling hos t
cards.
4. Repeat step 3. until you have installed all the UltraPort cards you want.
5. Replace and secure the system cover.
Installation of UltraPort cards is now complete.
UltraPort Serial Adaptors User Guide Installing host cards and cable accessories
Chapter 2 Installing drivers and host cards
Page 95
Page 96

Installing cables and connector boxes

This section describes the mechanical installation of cables and connector boxes to the UltraPort host cards for 1, 2, 4, 8 and 16 ports and includes the following:
Installing cables on UltraPort1, UltraPort1 SI, UltraPort1 Express, UltraPort2, and
UltraPort2 SI cards on page 97
Installing converter cables on UltraPort2 Express, UltraPort4, UltraPort4 Express,
and UltraPort4 SI-RJ45 cards on page 97
Installing converter cables on UltraPort8i, and UltraPort81 Express cards on page 97
Installing fan-out cables and connector boxes on UltraPort4 SI-LP, UltraPort4
Express HD, UltraPort 8 SI, UltraPort8, and UltraPort8 Express HD cards on page 98
Installing fan-out cables and connector boxes on UltraPort16 and UltraPort16 SI
cards on page 99
For information on available connectors and their pinouts and cabling, see Chapter 3
Cabling information.
UltraPort Serial Adaptors User Guide Installing host cards and cable accessories
Chapter 2 Installing drivers and host cards
Page 96
Page 97
Installing cables on UltraPort1, UltraPort1 SI, UltraPort1 Express, UltraPort2, and UltraPort2 SI cards
The UltraPort1, UltraPort1 SI and the UltraPort1 Express have a single DB9 male connector on the back panel and UltraPort2 and UltraPo rt2 SI cards h ave two DB9 male con nectors on the back panel. There is one for each serial port and they are labelled 1 to 2.
You can connect peripheral serial devices directly to the UltraPort2 card by using st andard
RS-232 DB9 female connectors on the adapter side of the cable
connect the peripheral device.
you are using to
Installing converter cables on UltraPort2 Express, UltraPort4, UltraPort4 Express, and UltraPort4 SI-RJ45 cards
UltraPort2 Express, UltraPort4, UltraPort4 Express and the UltraPort4 SI-RJ45 cards have two to four RJ45 10-pin connectors on the back panel. There is one for each serial port and they are labelled 1 to 4.
Converter cables with the proper connector on the opposite end can be plugged into these RJ45 connectors to provide the desired interface.
Installing converter cables on UltraPort8i, and UltraPort81 Express cards
UltraPort8i, and UltraPort81 Expresscards have eight RJ12 6-pin connectors on the back panel. There is one for each serial port.
Converter cables with the proper connector on the opposite end can be plugged into these RJ12 connectors to provide the desired interface.
UltraPort Serial Adaptors User Guide Installing host cards and cable accessories
Chapter 2 Installing drivers and host cards
Page 97
Page 98
Installing fan-out cables and connector boxes on UltraPort4 SI-LP, UltraPort4 Express HD, UltraPort 8 SI, UltraPort8, and UltraPort8 Express HD cards
UltraPort4 Express HD, UltraPort4 SI-LP, UltraPort8 SI and UltraPort8, UltraPort8 Express HD
signals for 4 or 8 serial ports. A fan-out cable or connector box with the proper individual connectors can be plugged into
the card to provide the desired interface. The port numbers will be identified on the interface connectors or connector box.
cards have a single VHDCI-68 connector on the back panel. It provides the
Note The UltraPort fan-out cables and connector boxes need to be secured or
supported in case of sudden contact or excessive weight on the cables. Please ensure that adequate caution is t aken to avoid possible damage to the UltraPort card or Host system. This can be accomplished by securing the cable(s) to a rack or to the back of the server as shown below:
UltraPort Serial Adaptors User Guide Installing host cards and cable accessories
Chapter 2 Installing drivers and host cards
Page 98
Page 99
Installing fan-out cables and connector boxes on UltraPort16 and UltraPort16 SI cards
UltraPort16 and UltraPort16 SI cards have two VHDCI-68 connectors on the back panel. Each one provides the signals for 8 serial port s, to provide a total of 16 ports. The con nectors are labelled “1 - 8” and “9 - 16” on the back panel, to indicate the port numbers that are provided on each connector.
A fan-out cable or connector box with the proper individual connectors can be plugged into each connector on the card to provide the desired interface for 8 ports. The port numbers will
be identified on the interface connectors or connector box.
Note On an UltraPort16 and UltraPort16 SI card, the port numbers for ports on the
connector labelled “9 - 16” will be 8 higher than the numbers given on the interface connectors of the fan-out cable or connector box.
Note The UltraPort fan-out cables and connector boxes need to be secured or
supported in case of sudden contact or excessive weight on the cables. Please ensure that adequate caution is t aken to avoid possible damage to the UltraPort card or Host system. This can be accomplished by securing the cable(s) to a rack or to the back of the server as shown below:
UltraPort Serial Adaptors User Guide Installing host cards and cable accessories
Chapter 2 Installing drivers and host cards
Page 99
Page 100

Removing host cards

To remove an UltraPort card from your system, proceed as follows:
Note The exact location of host card slots varies for different systems, for exact mechanical
details of your system, refer to your system documentation.
1. Turn off the power to your system and unplug the power cord.
2. Remove the system cover to expose the inside of the connector panel for host cards.
3. Disconnect any cables or connector boxes connected to the card you want to remove.
4. Undo the securing screw for the host card you want to remove then lift the card out of its slot as shown in the next picture.
Warning Dangerous voltages exist inside computer systems. Before
removing host cards from your system, turn off the powe r supply and unplug the power cord.
Caution Full anti-static precau tions should be t aken when handling hos t
cards.
5. Repeat from step 3. until you have removed all the host cards you want.
6. Replace and secure the system cover.
7. Plug in the mains lead and turn on the power.
Removal of UltraPort card is now complete.
UltraPort Serial Adaptors User Guide Removing host cards
Chapter 2 Installing drivers and host cards
Page 100
Loading...