Digi NetSilicon Connectware Connect Series User manual

Digi Connect User's Guide
hwref_ns7520.book Page 1 Friday, September 19, 2003 11:03 AM

 Digi International Inc. 2003. All Rights Reserved
The Digi logo and RealPort are registered trademark of Digi
International, Inc.
Connectware and Digi Connect ME are trademarks of Digi
International, Inc.
Adobe and Adobe Acrobat are registered trademarks of
Adobe Systems, Inc.
Microsoft and Windows are registered trademarks of
Microsoft Corporation.
Information in this document is subject to change without
notice and does not represent a commitment on the part of
Digi International.
Digi provides this document “as is,” without warranty of any
kind, either expressed or implied, including, but not limited to,
the implied warranties of fitness or merchantability for a
particular purpose. Digi may make improvements and/or
changes in this manual or in the product(s) and/or the
program(s) described in this manual at any time.
This product could include technical inaccuracies or
typographical errors. Changes are periodically made to the
information herein; these changes may be incorporated in
new editions of the publication.

Contents 5
About This Guide
Objective............................................................................................... 7
Audience............................................................................................... 7
Related Information............................................................................... 7
Chapter 1 Quick Start Setup
Introduction........................................................................................... 9
Quick Start Overview............................................................................ 9
Quick Start Procedure........................................................................... 9
Chapter 2 Configuring Network Settings
Introduction......................................................................................... 13
Configuring Network Settings ............................................................. 13
Chapter 3 Configuring Network Communications
Introduction......................................................................................... 15
Setting Up RealPort COM Port Redirection........................................ 16
Configuring a TCP or UDP Server .................................................... 18
Configuring a TCP Client.................................................................... 20
Configuring a UDP Client ................................................................... 22
Chapter 4 Configuring GPIO Pins and Alarms
Introduction......................................................................................... 25
Configuring the GPIO Pins.................................................................. 26
Configuring Alarms ............................................................................. 27
Contents

6Contents
Chapter 5 Testing GPIO Functionality
Introduction......................................................................................... 29
Getting Familiar with GPIO Input........................................................ 29
Getting Familiar with GPIO Output ..................................................... 30
Chapter 6 Administration
Introduction......................................................................................... 31
Restoring the Configuration to Factory Defaults................................. 31
Backing Up the Configuration ............................................................ 31
Restoring the Configuration................................................................ 32
Viewing System Information ............................................................... 32
Viewing Serial and GPIO Port Statistics ............................................ 33
Rebooting the Module......................................................................... 33
Index........................................................................................................ 35

7
Objective This manual shows you how to configure and administer the
Digi Connect product family. Once configured, you can access
the web interfaceandbecome familiar with the capabilities.
Audience This manual is intended for those responsible for setting up
a Digi Connect product. It assumethatthe readeris somewhat
familiar with networking.
Related Information
In addition to this manual, the following documents are part of
the Digi Connect library:
•Digi Connect platform Hardware Reference
•Digi Connect Customization Guide
About This Guide

8RelatedInformation

Chapter 2 Quick Start Setup 9
IntroductionThischapter describeshow to set up the Digi Connect
product and installthe customization kit.
Quick Start Overview
1. Physically connect the hardware.
2. Install the software and tools.
3.Locate the product on the network and configure network
settings.
4.Access the product from aweb browser.
5. Getfamiliar with theproduct andcustomization kitfeatures.
Quick Start Procedure
1.Connect the Ethernet cable to the product.
2.Connect the power to the Digi Connect product.
The following figureshows a hardwareset up for Connect ME.
Chapter2
Quick Start Setup

10 Quick Start Procedure
Task 2: Install the Software and Tools
3.Place the customization kit CD inthe CDdrive.
The installation wizard appears.
4. Choose Next to start the installation process.
5. Choose I Agree to the license agreement prompt and then
click Next.
6. Choose an installation type.
• Typical means that sample applications, documenta-
tion, and RealPort will be installed and third-party
applications will not be installed. These include the fol-
lowing:
— Adobe Acrobat Reader. Install this application if
you want to view online documentation and the
Reader is not already on your system.
— Microsoft InternetExplorer (IE) 6. Install IE 6 if your
Ethernet switch
Power supply Ethernet
connection
P1 P2
P3

Chapter 2 Quick Start Setup 11
current browser does not support the Java plug-in,
which is required to view the Java-based
configuration application.
— Sun Java Run-time Environment (JRE) 1.4.1.
Install the JRE if you need the Java plug-in.
• Advanced means that you pick components to install.
7. Follow the prompts to complete installation.
Task 3: Locate the Digi Connect product and Configure Network Settings
8. From the Windows Start Menu, choose Programs > Digi
Connect > DigiDevice Discovery.
Device Discoverylocates and lists Digi products on the net-
work.
9.Select yourproduct from the list and do one of the follow-
ing:
•If aDHCPserver assigned anIP address to your
product, gotothe next step.
•If yourproduct requires an IP address, choose
Configure Network Settings and assign network set-
tings.
Task 4: Access theProduct froma WebBrowser
10.Selectthe product and thenchooseOpen Web Interface.
A browser connection is opened to the module.
Note: If you did not install the JRE and do not have it on your sys-
tem, it will be downloaded from the internet prior to the con-
figuration application opening. This can take several minutes.
11.Use the browserinterface to configure the product and get
familiar with its features.

12 Quick Start Procedure

Chapter 3 Configuring Network Settings 13
IntroductionThis chapter describes how to change network settings. It
assumes that you have assigned initial network settings to
the product as described in "Quick Start Setup" on page 9.
Configuring Network Settings
Introduction
This section provides information on changing network
settings, such as the module’s IP address, subnet mask, and
default gateway.
Procedure
1.Access the web interface byentering the product’s IP
address in a browser’s URL window.
2. Choose Network from the Configuration menu.
3. Choose the Basic tab.
4. Make changes as required and then choose Save. See
your network administrator to gather the information
requiredto ensure thattheproduct is configured correctly
for your network. See the table that follows for information
on configuration fields.
Chapter 3 Configuring Network Settings

14 ConfiguringNetworkSettings
Note: When you change the network configuration, a reboot is
required, which means you willhave to reconnect to the
product with yourbrowser.
Setting Description
Obtain automati-
cally using DHCP
Choose this option to assign network settings
using a DHCP server. A new IP address will
be assigned when the product reboots.
Choose this setting only if you have a DHCP
server.
Use the following IP
address Choose this optionto configure the product
with the IP address supplied in the IP
Address field.
IPAddressSpecify an IP addressto assign the product.
Subnet Mask Specify the subnet mask used on this net-
work.
Default Gateway Specify the IP address of the default gateway
orrouterwhose services the product will use
to route messages to systems and devices
on other networks.

Chapter 4 Configuring Network Communications 15
IntroductionThis chapter describesa number ways to set up the product
to provide communication services to devices connected to
its serial port; it also provides detailed setup information.
Chapter 4
Configuring Network
Communications

16 Setting Up RealPort COM Port Redirection
Setting Up RealPort COM Port Redirection
Introduction
This section discusses RealPort COM port redirection. It
describes what RealPort is and provides detailed instruction
for installing the RealPort driver on a Microsoft Windows
system. It also provides information on downloading the
latest RealPort driver from the Digi web site.
What is RealPort?
RealPort is a network communication option for applications
designed to communicate with serial devices using COM
ports. With RealPort, the application simply opens a
RealPort virtual COM port that directs the data across the
network to your device.
The advantage of this option is that neither the application
nor the serial device need to be changed from their original
serial communication model to work on a network. Both
continue to use serialcommunication techniques, and neither
is aware of the intervening network.
In the figure that follows, an application and your device with
the embedded Digi Connect ME module communicate as
though they were connected with a serial cable.

Chapter 4 Configuring Network Communications 17
Procedure: Installing RealPort
Use this procedure to install RealPort software on the same
computer that the Integration kit software and tools were
installed.
1. From the Start Menu, choose Programs > Digi Connect
> RealPort>InstallRealPortXxx, where Xxx is a version
or versions of MicrosoftWindows.
2. Follow the on-screen documentation to complete installa-
tion. When the installation completes, RealPort will be
ready to use.
N
etwork
(
E
thernet
)
R
eal
P
ort
S
oftware

18 Configuring a TCP or UDP Server
Procedure: Downloading and Installing RealPort
Use this procedure to download and install a RealPort driver
from the Digi web site.
1. Go to www.digi.com
2. Locate the RealPort driver and follow the instructions for
downloading it.
3. Use the readme.html file for installation instructions.
When the installation completes, RealPort will be ready to
use.
Configuring a TCP or UDP Server
Introduction
This section describes how to set up the module as a TCP or
UDP server. It describes the features of this configuration and
provides information on configuring the product.
About This Configuration
This configuration provides TCP or UDP socket service for a
device connected to the serial port. In this configuration,
another networked device or application initiates
communication. The product simplywaits for incoming traffic
and passes data to the serial device. The figure illustrates
this configuration.

Chapter 4 Configuring Network Communications 19
Procedure:Configuring Digi ConnectasaTCP/UDP Server
1.Access the web interface byentering the product’s IP
address in a browser’s URL window.
2. Choose Serial Ports from the Configuration menu.
3. Choose the Basic tab and then configure serial communi-
cation settings. When you complete this task, choose
Save.
4. Choose either the TCP or UDP tab.
5. Check the Enable TCP Server or Enable UDP Server box
and then configure a TCP orUDP portto which the
product will pass incomingdata. Use the portnumber required
by your application.
6. Choose Save.

20 Configuring a TCP Client
Configuring a TCP Client
Introduction
Thissection describes howtoconfigurethe product as a TCP
client. It describes the features of this configuration and
provides detailed setup procedures.
About This Configuration
In this configuration, the device initiates TCP connections to
applications running on servers or to devices connected to
server serial ports. This is sometimes called TCP socket
service. The connection can be configured to be always
active or to be triggered by a particular event, such as when
the DCD signal goes high or data arrives at the port. The
figure illustrates this configuration.

Chapter 4 Configuring Network Communications 21
Procedure
1.Access the web interface byentering the product’s IP
address in a browser’s URL window.
2. Choose Serial Ports from the Configuration menu.
3. Choose the Basic tab and configure serial communication
settings. When you complete this task, choose Save.
4. Choose the TCP tab and then configure TCP Client set-
tings. Use the following table for information on settings.
When you are done choose Save.
Setting Description
Automati-
cally estab-
lish TCP
connections
Checkthisfield if you want the product to trigger auto-
matic TCP connections to the server identified on the
Connect To field. Connections will be triggered by the
event specified in the Connect field.
Connect
Configure the event that will trigger a connection:
• Always means a connection is always available.
If lost, the connection will be reestablished auto-
matically.
•Data means the product initiates aconnection
whenever data arrives on the serial port.
• DSR means a connection is made when the
serial port's DSR signal goes high.
• DCD means a connection is made when the
serial port's DCD signal goes high.
Connect to Specify the IP address of the server to which a con-
nection will be made.
Service Configure the type of service to use.
TCP Port
Number Configure the TCP port number for this connection. Use the port number required by the application.