Raveon FireLine Ethernet User manual

FireLine System Protocol Manual 1 Raveon Technologies Corp.
F i r eL i n e E t h e r n e t
Radio Modem
T e c h n i c a l M a n u a l
Version E1
March 2007
Raveon Technologies Corporation
2780 La Mirada Dr. Suite C
Vista, CA 92081
760-727-8004
www.raveontech.com
Powered By:

FireLine System Protocol Manual 2 Raveon Technologies Corp.
Table of Contents
1. Overview........................................................................................................3
2. Di i Connect ME............................................................................................5
2.1. Documentation............................................................................................................................. 5
2.2. Security Features......................................................................................................................... 6
2.3. The Default Web Interface ........................................................................................................... 6
2.4. Usin the Di i Discovery Pro ram ............................................................................................... 6
Open the Web Interface...................................................................................... 7
By Enterin the Device’s URL in a Web Browser ............................................... 7
2.5. User Interfaces............................................................................................................................. 7
3. Confi urin the Ethernet Interface .................................................................7
3.1. Assi nin an IP Address to the FireLine ...................................................................................... 7
Prerequisites....................................................................................................... 8
Procedure ........................................................................................................... 8
3.2. Enable or Disable Network Services............................................................................................ 9
Network Services that Can Be Enabled or Disabled........................................... 9
4. Telnet Operation ..........................................................................................10
4.1. About TCP and UDP Port Numbers........................................................................................... 10
4.2. Confi urin the FireLine Ethernet for Telenet Operation ........................................................... 10
5. RealPort Virtual COM port ...........................................................................13
5.1. RealPort Software...................................................................................................................... 13
5.2. Encrypted RealPort.................................................................................................................... 14
5.3. Creatin a Virtual Port................................................................................................................ 14
5.4. Quick Test of Virtual COM port .................................................................................................. 15
6. TCP/IP Socket Operation ............................................................................16
6.1. About TCP and UDP Port Numbers........................................................................................... 16
6.2. Confi urin the FireLine TCP Socket Operation........................................................................ 16
7. Important Safety Information........................................................................18

FireLine System Protocol Manual 3 Raveon Technologies Corp.
1. verview
The ireLine Ethernet radio modem combines two products in one unit. It is a
ireLine radio modem, with all of the features and functions of Raveon’s ireLine
series of radio modems, alon with a Digi Connect Ethernet interface.
The ireLine Ethernet radio modem has two user I/O ports. Either one or both
may be used to send and receive data over the radio channel. Data from both
ports is sent over the air, and all data received over the air will come out both
ports.
The serial port is a standard RS-232 serial port, which operates the same on all
ireLine radio modems. It can be used to send/receive data or to mana e the
confi uration.
The 10./100 Ethernet interface supports many different network protocols. Your
application will dictate which is the best mode to use. If you would like
assistance in choosin the best protocol, contact Raveon Application Support to
discuss which is best for you. Available Protocols are:
• Telnet
• Realport COM port emulation.
• Udpserial
• TCP Sockets

FireLine System Protocol Manual 4 Raveon Technologies Corp.
All Ethernet functions are implemented usin the embedded Digi Connect ME
1
module within the ireLine Ethernet radio modem. This module is made by Digi
International, Inc. of Minnetonka, Minnesota a division of NetSilicon. The Digi
Connect ME interface is built on leadin 32-bit ARM technolo y usin the
network-attached NetSilicon NS7520 microprocessor, the Di i Connect ME
combines true plu -and-play functionality.
The most strai htforward method to implement the ireLine Ethernet is the “COM
Port Redirection” technique, usin Realport software. The ireLine Ethernet uses
the patented RealPort COM/TTY port redirection for Microsoft Windows, UNIX,
and Linux environments. RealPort software provides a virtual connection to serial
devices, no matter where they reside on the network. The software is installed
directly on the host and allows applications to talk to devices across a network as
thou h the devices were directly attached to the host on a COM port.
In the system above, any application runnin on the system computer will talk
over the RF link as if it were a COM serial port on the PC. In most of these types
of applications, the user’s application software needs no customization. It simply
communicates to a COM port, and thinks the FireLine Ethernet is plu ed into a
serial port on the system PC.
FireLine Ethernet modems may be used in radio networks with other FireLine
Ethernet modems, or with standard RS232/RS485 FireLine modems, effectively
connectin the System PC/Device to a remote serial port, via the wireless link as
shown below.
1
Connectware, Di i Connect EM, Di i Connect ME, Di i Connect SP, Di i Connect Wi-EM, and Di i Connect Wi-ME are
trademarks of Di i International, Inc.

FireLine System Protocol Manual 5 Raveon Technologies Corp.
2. Digi Connect ME
The Di i Connect ME module is the Ethernet interface used within the FireLine
Ethernet radio modem. The followin sections provide an overview of its
capabilities. Please refer to the appropriate Digi Connect ME documentation for
details on its capabilities.
2.1. Documentation
The advanced features in the FireLine Ethernet are implemented in the Di i
Connect Ethernet interface module used within the product. This manual covers
an abbreviated version of the Di i Connect documentation and is suitable to use
to confi ure the Virtual COM port and Telnet functions of the product. For other
features, consult the appropriate Di i documentation included on the CD that
came with your FireLine Ethernet. They are also available on the Di i web site at
http://www.di i.com/ (>Support >Documentation) The Di i Connect documents
are:
Digi Connect amily Command Reference
Realport Installation Guide
Digi Connect User’s Guide
RCI Specification
The FireLine Ethernet modem has all the features of a standard FireLine radio
modem, and is confi ured in the same way as an RS232 FireLine. Refer to
Raveon’s ireLine MODEM Technical Manual for information on how to
confi ure all radio modem parameters such as frequency, data rates, and
dia nostics. This is available at: http://www.raveontech.com/Manuals/RV-
M5_Tech_Manual.pdf .

FireLine System Protocol Manual 6 Raveon Technologies Corp.
2.2. Security Features
Network recurity-related features in Di i Connect devices include:
• Secure access and authentication:
• One password, one permission level. (Default user: root Default password: dbps )
• Can issue passwords to device users.
• Can selectively enable and disable IP services: network services such as ADDP,
RealPort, Encrypted RealPort, HTTP/HTTPS, LPD, Remote Lo in, Remote Shell,
SNMP, and Telnet, can be enabled and disabled.
Secure sites for confi uration: HTML pa es for confi uration have appropriate
security.
• Encryption: Di i Connect devices include stron Secure Sockets Layer
(SSL) V3.0/
• Transport Layer Security (TLS) V1.0-based encryption: DES (56-bit),
3DES
• (168-bit), AES (128-/156-bit): Encrypted RealPort offers encryption for the
Ethernet connection between the
• COM/TTY port and the Di i Connect device: Wireless Di i Connect
devices provide Wi-Fi Protected Access (WPA) and
• SNMP security: Authorization: Chan in public and private community
names is recommended to prevent unauthorized access to the device.
You can disable SNMP set commands to make use of SNMP read-only.
2.3. The Default Web Interface
A default web interface is provided as an easy way to confi ure and monitor Di i
Connect devices like the ireLine Ethernet modem. Confi urable features are
rouped into several cate ories: Network, Serial Port, Alarms, Security, and
System. Most of the confi urable features are arran ed by most basic settin s on
a pa e, with associated and advanced settin s accessible from that pa e. As in
the Di i Device Setup Wizard, serial port confi urations are classified into port
profiles, or confi uration scenarios that allow you to select the scenario that best
represents the environment and set up the appropriate parameters that are
needed.
When confi urin some features, you may want to establish a basic confi uration
usin the Di i Device Setup Wizard, and then fine-tune the confi uration usin
the default web interface.
2.4. Using the Digi Discovery Program
The Digi Discovery Program is the preferred method of mana in your ireLine
Ethernet products. It is an easy-to-use pro ram that displays all Di i powered
devices, and with a few clicks, allows you to confi ure them. When you run the
Di i Discovery pro ram called “dgdiscvr.exe”, the pro ram will search for all Di i
devices, and display a list of them on your screen.

FireLine System Protocol Manual 7 Raveon Technologies Corp.
Note: When power is first applied to the Ethernet ireLine, it may take the Di i
Connect module up to 30 seconds to boot-up, and be in normal communications
on the network.
pen the Web Interface
To open the default web interface, you can either:
• Enter the Digi Connect device’s URL in a Web browser and log on to the device, if required.
• Use the Digi Device Discovery utility to locate the device and open the Web interface.
By Entering the Device’s URL in a Web Browser
In the URL address bar of a Web browser, enter the IP address of the device. If
security has been enabled for the device, a lo in dialo will be displayed. Enter
the user name and password for the device. If you do not know the user name
and password for the device, contact the system administrator who initially set up
the device.
After you lo on, the Home pa e of the default web interface is displayed and
you are ready to confi ure the Ethernet interface on the FireLine
2.5. User Interfaces
ireLine Ethernet data radios with the Di i Connect device support a variety of
user interfaces for confi urin and monitorin tasks, includin :
•
The Di i Device Setup Wizard
•
A default web-based interface (Preferred)
•
An optional Java-applet interface
•
Telnet Command-Line Interface
•
Confi uration via Remote Command Interface (RCI) over the serial port
•
Simple Network Mana ement Protocol (SNMP)
3. Configuring the Ethernet Interface
3.1. Assigning an IP Address to the FireLine
There are several ways to assi n an IP address to a ireLine Ethernet:
• Usin the Di i Device Setup Wizard.
• Usin Dynamic Host Confi uration Protocol (DHCP) from the default web
interface (only for chan in the IP address once it has been assi ned).
• Usin the Command-Line Interface.
• Usin Automatic Private IP Addressin (APIPA), also known as Auto-IP.
This section describes how to confi ure the device with the Di i Setup Wizard.
To use the other methods, refer to the “Digi Connect amily User Guide”
supplied on the CD with your FireLine Ethernet modem.

FireLine System Protocol Manual 8 Raveon Technologies Corp.
Usin the Di i Device Setup Wizard is the preferred method of assi nin an IP
address and initially confi urin your Di i Connect device. The Di i Device Setup
Wizard is supplied on the CD that accompanies your Di i Connect device.
The Di i Device Setup Wizard “discovers” the device, and then provides a
method for assi nin an IP address as well as confi urin your device for your
needs. It can be used in conjunction with the web interface to ‘tweak’ the specific
environment. Setup is specially desi ned for the Windows environments, and is
quick, automated, and complete.
Prerequisites
This procedure assumes the followin :
• The ireLine Ethernet device is connected to the network and powered up.
• The CD will be used on a system running Microsoft Windows operating system
• or a Unix operating system.
• That you have located the device server’s MAC address, located on the label on
• the bottom of the product, and recorded it for later use in assigning an IP
• address.
Procedure
1. Insert the Di i CD in the CD drive.
2. If the CD does not start automatically, double-click My Computer > CD
ROM Drive > setup.exe
3. The Di i Device Setup Wizard will automatically pop up. Select your
platform and click Next.
4. The Di i application finds and lists all of the Di i devices on your network.
5. Locate your device server by its MAC address.
6. Select the device server and then click Next.
7. Follow the instructions in the wizard to confi ure your Di i Connect device.
The default user is: root The default password is: dbps Use the online
help supplied with the wizard if you need more information about values
the wizard prompts you to supply and select.
The main confi ure menu for settin the IP address in the FireLine Ethernet will
look like the screen snapshot below. In this example, the FireLine Ethernet is
confi ured with a static IP address.

FireLine System Protocol Manual 9 Raveon Technologies Corp.
3.2. Enable or Disable Network Services
The Network Services pa e shows a set of common network services that are
available for devices, and the port on which the service is runnin .
You can enable or disable several common network services and confi ure the
TCP port they listen on. Disablin services may be done for security purposes.
That is, you can disable certain services so that a device is runnin only those
services specifically needed by the device. As needed, you can also disable any
non-secure services, such as Telnet.
Network Services that Can Be Enabled or Disabled
Followin are the network services which can be enabled or disabled. By default,
all services are ENABLED.
• ADDP: This service controls use of Advanced Digi Device Discovery Protocol. If it is
disabled, you can no longer use the Digi Device Setup Wizard, or Digi Device
Discovery utility to locate the device.
• HTTP & HTTPS: These services control the use of the Web interface. If you disable them,
device users cannot use the default web interface or Java applet to configure,
monitor, and administer the device.
• RealPort or Encrypted RealPort: These services control use of COM port redirection. If
disabled, COM port redirection cannot be used for the device.
• Rlogin: Enables or disables the remote login (rlogin) service. If disabled, users cannot
perform a remote login to the device.
• Rsh: Enables or disables the remote shell (rsh) service.

FireLine System Protocol Manual 10 Raveon Technologies Corp.
• SNMP: Enables or disables the use of SNMP. If disabled, SNMP services such as traps
and device information are not used.
• Telnet: Enables or disables the Telnet service. If disabled, users cannot Telnet to the to the
device.
4. Telnet peration
FireLine Di i Connected devices support the followin types of Telnet
connections:
• Telnet Client
• Telnet Server
• Reverse Telnet, often used for console management or device management
• Telnet Autoconnect
• R C 2217 (Telnet Com Port Control Option)
For more information on these connections, see the section "Supported
Connections and Data Paths" in the Digi Connect amily User’s Guide.
Access to Telnet network services can be enabled or disabled.
Note: When the ireLine Ethernet with Di i Connect is first powered on, it may
take up to 30 seconds to boot-up, and be in normal communications on the
network interface.
4.1. About TCP and UDP Port Numbers
Di i Connect devices use the followin default TCP and UDP port numberin
conventions described in the followin table: You must ensure that the
application or device that initiates communication with the Connect device uses
these ports. If they cannot be confi ured to use these ports, you chan e the
individual network port on the Di i Connect device, which allows you different
port numbers to desi nate a Telnet or raw connection to the serial port.
For this connection type... Use these ports:
• Standard Unencrypted Telnet, port 23.
• Telnet to the seria,l port 2001 (TCP only)
• Raw connection to the serial, port 2101(TCP and UDP)
4.2. Configuring the FireLine Ethernet for Telenet peration
This procedure assumes the IP address of the FireLine Ethernet radio modem
has already been set, as per the previous section.
1. Usin the Di i Connect Discovery pro ram, select and lo into your FireLine
Ethernet modem’s web interface.

FireLine System Protocol Manual 11 Raveon Technologies Corp.
2. From the main menu, select “Serial Ports”. This will display the current serial
port confi uration as shown below.
3. Click on Port1, to display its confi uration. The port profile shoul dbe “Console
Mana ement” as shown below. If it does, skip to step 5, if not, perform step 4.
4. If the port is not in Console Mana ement profile, click on “Chan e Profile, and
select “Console Mana ement” and press “Apply”.
5. Click on “Basic Serial Settin s” on the bottom of the Serial Port Confi uration
screen. Set the serial port parameters as shown below and press “Apply”.
The baud rate must be 57600bps, as that is the internal serial port baud rate
that the ireLine’s modem uses to communicates with the Di i Connect

FireLine System Protocol Manual 12 Raveon Technologies Corp.
module.
6. Select Network Confi uration
and then “Network Services Settin s

FireLine System Protocol Manual 13 Raveon Technologies Corp.
7. In Network Service Settin s, hi hli ht only the service you wish to use. For
Telenet, the minimum recommended is: ADDP, Telnet, and HTTP.
The FireLine Ethernet is now ready to use as a Telnet server. To lo into the
ireLine Ethernet, open up any telenet pro ram, and connect to the IP address of
the ireLine Ethernet usin port 23. Lo in with the user name and password.
The default user is: root The default password is: dbps.
Use the “Connect 1” command to connect to the FireLine. Once connected, all
characters from the Telnet session will pass directly to the FireLine and be sent
over the air. All over the air data will be directed to the Telnet application.
5. RealPort Virtual C M port
5.1. RealPort Software
The ireLine Ethernet uses the patented RealPort COM/TTY port redirection for
Microsoft Windows, UNIX, and Linux environments. RealPort software provides a
virtual connection to serial devices, no matter where they reside on the network.
The software is installed directly on the host and allows applications to talk to
devices across a network as thou h the devices were directly attached to the
host. Actually, the devices are connected to a Di i device server or terminal
server somewhere on the network.
RealPort is unique amon COM port re-directors because it is the only
implementation that allows multiple connections to multiple ports over a sin le
TCP/IP connection. Other implementations require a separate TCP/IP connection
or each serial port. Unique features also include full hardware and software flow
control, as well as tunable latency and throu hput.
FireLine Ethernet devices with the Di i Connect module support RFC 2217, an
extension of the Telnet protocol used to access serial devices over the network.

FireLine System Protocol Manual 14 Raveon Technologies Corp.
RFC 2217 implementations enable applications to set the parameters of remote
serial ports (baud rate, flow control, etc.), detect line si nal chan es, as well as
receive and transmit data. The confi uration information provided in this section
applies to devices functionin as RFC 2217 servers.
Access to RealPort services can be enabled or disabled.
Note: When the ireLine Ethernet with Di i Connect is first powered on, it may
take up to 30 seconds to boot-up, and be in normal communications as a virtual
COM port.
5.2. Encrypted RealPort
Encrypted RealPort offers a secure Ethernet connection between the COM or
TTY port and a device server or terminal server. Encryption prevents internal and
external snoopin of data across the network by encapsulatin the TCP/IP
packets in a Secure Sockets Layer (SSL) connection and encryptin the data
usin Advanced Encryption Standard (AES), one of the latest, most efficient
security al orithms.
Di i’s RealPort with encryption driver has earned Microsoft’s Windows Hardware
Quality Lab (WHQL) certification. Drivers are available for a wide ran e of
operatin systems, includin Microsoft Windows Server 2003, Windows XP,
Windows 2000, Windows NT, Windows 98, Windows ME; SCO Open Server;
Linux; AIX; Sun Solaris SPARC; Intel; and HP-UX. It is ideal for financial,
retail/point-of-sale, overnment or any application requirin enhanced security to
protect sensitive information.
5.3. Creating a Virtual Port
1. Install the provided Di i Connect software on the PC that will have the virtual COM port.
2. Connect the ireLine Ethernet device to the network.
3. Apply power to the ireLine Ethernet modem. The Ethernet connector has two LEDs
located near the RJ-45 connector. The amber LED should be illuminated indicatin the
device is powered ON and connected to the network. The reen LED will flicker when the
device detects network traffic.
4.
Assi n the Di i Connect device an IP address usin the device discovery pro ram. See
the section of this manual “Confi urin the Ethernet Interface” for details on how to set
the IP address of the ireLine Ethernet.
5.
Confi ure the ireLine Ethernet module for RealPort virtual COM port usin the Di i
Device Discovery pro ram.
a. Start > All Programs > Digi Connect > Digi Device Discovery
b. You should see a list of Di i Connect devices listed in the window.
c. Select the desired Di i Connect device from the window listin .
d. Select Open Web Interface in the Device Tasks window.
e.
User Name: root
f. Password: dbps

FireLine System Protocol Manual 15 Raveon Technologies Corp.
. Select Serial Ports in the Confi uration menu.
h.
Select Port 1 under Serial Port confi uration.
i.
Select the RealPort port profile and click the apply button. It is not necessary to
confi ure basic serial port settin s since they will be set by the application
runnin the real port driver.
6. Install the RealPort driver on the PC that will be communicatin with the
FireLine Ethernet. These drivers are included in the “realport” directory on
the CD supplied with your FireLine Ethernet.
a. Start > All Programs > Digi Connect > ealPort Drivers
b. Select the appropriate folder for your PC’s operatin system.
c. Run the Setup Application. The Setup Wizard will display all the Di i Connect
devices currently connected to the network.
d. Hi hli ht the desired device and select the Next button. If you’re unsure about
which is the correct device, the MAC address is displayed on the serial number
label of the ireLine Ethernet device .
e. Select a COM port to use as the virtual communication port. The select the Next
button. Remember this is a virtual port, not an actual port on the PC, so select a
port other than those available on the PC.
5.4. Quick Test of Virtual C M port
A communication pro ram such as HyperTerminal may be used to test the
ireLine’s virtual COM port confi uration. On the PC that is confi ured with the
Virtual COM port, open HyperTerminal.
Confi ure HyperTerminal to communicate with the FireLine modem usin the
Virtual COM port.
Important! SET the baud rate to 57600bps.

FireLine System Protocol Manual 16 Raveon Technologies Corp.
The FireLine expects the virtual COM port baud rate to be set at 57600.
You should now be able to communicate with the ireLine Ethernet throu h the
virtual COM port as thou h it was connected directly to your PC’s COM port.
Characters typed into HyperTerminal will be transmitted over the air, and you can
enter the FireLine confi uration mode by typin +++ in the same way you can
had the PC been connected usin an RS-232 cable.
6. TCP/IP Socket peration
FireLine Ethernet devices with the Di i Connect module support data transfer
usin a TCP/IP socket.
6.1. About TCP and UDP Port Numbers
Di i Connect devices use the followin default TCP and UDP port numberin
conventions described in the followin table: You must ensure that the
application or device that initiates communication with the Connect device uses
these ports. If they cannot be confi ured to use these ports, you chan e the
individual network port on the Di i Connect device, which allows you different
port numbers to desi nate a Telnet or raw connection to the serial port.
For this connection type... Use these ports:
• Telnet to the serial port 2001 (TCP only)
• Raw connection to the serial port 2101(TCP and UDP)
6.2. Configuring the FireLine TCP Socket peration
This procedure assumes the IP address of the FireLine Ethernet radio modem
has already been set, as per the previous section.
1. Usin the Di i Connect Discovery pro ram, select and lo into your
FireLine Ethernet modem’s web interface.
2. From the main menu, select “Serial Ports”. This will display the current
serial port confi uration as shown below.
8. Click on Port1, to display its confi uration. The Port Profile should be “TCP
Sockets” as shown below. If it does, skip to step 5, if not, perform step 4.

FireLine System Protocol Manual 17 Raveon Technologies Corp.
9. If the port is not in TCP Socket profile, click on “Chan e Profile, and select
“TCP Sockets” and press “Apply”.
10. Click on “Basic Serial Settin s” on the bottom of the Serial Port Confi uration
screen. Set the serial port parameters as shown below and press “Apply”.
The Basic port settin for the baud rate must be 57600 for the FireLine
Ethernet.
11. Select Network Confi uration
and then “Network Services Settin s

FireLine System Protocol Manual 18 Raveon Technologies Corp.
The only Network Services that should be enabled are TCP sockets are
ADDP and HTTP.
The FireLine Ethernet is ready to operate usin a TCP Socket. To test it, you
can use a Telnet pro ram. Open a telnet session, usin port 2101. There will be
no lo in prompt. Simply type characters in the telnet window, and the FireLine
Ethernet wills send them over the air. All data received over-the-air will be
transferred over the network to the Telnet pro ram.
7. Specifications
Standard: .................................................................. IEEE 802.3
Physical Layer: ..................................................... 10/100Base-T
Data Rate: ....................................... 10/100Mbps (auto-sensin )
Mode: .......... Half-duplex and full-duplex support (auto-sensin )
Connector: .........................................................................RJ-45

FireLine System Protocol Manual 19 Raveon Technologies Corp.
8. Important Safety Information
To avoid contact with electrical current:
• Never install electrical wirin durin an electrical storm.
• Never install an Ethernet connection in wet locations unless that connector
is specifically desi ned for wet locations.
• Use caution when installin or modifyin Ethernet lines.
• Use a screwdriver and other tools with insulated handles.
• You and those around you should wear safety lasses or o les.
• Do not place Ethernet wirin or connections in any conduit, outlet or
junction box containin electrical wirin .
• Installation of inside wire may brin you close to electrical wire, conduit,
terminals and other electrical facilities. Extreme caution must be used to
avoid electrical shock from such facilities. You must avoid contact with all
such facilities.
• Ethernet wirin must be at least 6 feet from bare power wirin or li htnin
rods and associated wires, and at least 6 inches from other wire (antenna
wires, doorbell wires, wires from transformers to neon si ns), steam or hot
water pipes, and heatin ducts.
• Do not place an Ethernet connection where it would allow a person to use
an Ethernet device while in a bathtub, shower, swimmin pool, or similar
• hazardous location.
• Protectors and roundin wire placed by the service provider must not be
connected to, removed, or modified by the customer.
• Do not touch uninsulated Ethernet wirin if li htnin is likely!
• External Wirin : Any external communications wirin you may install
needs to be constructed to all relevant electrical codes. In the United
States this is the National Electrical Code Article 800. Contact a licensed
electrician for details.
• Do not touch or move the antenna(s) while the unit is transmittin or
receivin .