ProSoft Technology RLXIC-SG User Manual

RLXIC-SG
Intelligent Cellular
RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
May 29, 2009
USER MANUAL
Important Notice
Because of the nature of wireless communications, transmission and reception of data can never be guarante ed. Data may be delayed, corrupted (that is, it may have errors) or be totally lost. Although significant delays or losses of data are rare when wireless devices such as the RadioLinx Intelligent Cellular products are used in a normal manner with a well-constructed network, the RadioLinx Intelligent Cellular products (RLXIC-SG) should not be used in situations where failure to transmit or receive data could result in damage of any kind to the user or any other party, including but not limited to personal injury, death, or loss of property. ProSoft Technology accepts no responsibility for damages of any kind resulting from delays or errors in data transmitted or received using the Radio Linx Intelligent Cellular products, or for failure of the RadioLinx Intelligent Cellular products (RLXIC-SG) to transmit or receive such data.
Safety and Hazards
Do not operate the RadioLinx Intelligent Cellular products in areas where blasting is in progress, where explosive atmospheres may be present, near medical equipment, near life support equipment, or any equipment which may be susceptible to any form of radio interference. In such areas, the RadioLinx Intelligent Cellular products MUST BE POWERED OFF. The RadioLinx Intelligent Cellular products can transmit signals that co uld interfere with this equipment.
Do not operate the RadioLinx Intelligent Cellular products in any aircraft, whether the aircraft is on the ground or in flight. In aircraft, the RadioLinx Intelligent Cellular products MUST BE POWERED OFF. When operating, the RadioLinx Intelligent Cellular products can transmit signals that could interfere with various onboard systems.
Note: Some airlines may permit the use of cellular phones while the aircraft is on the ground and the door is open. RadioLinx Intelligent Cellular RLXIC-SG may be used at this time.
The driver or operator of any vehicle should not operate the RadioLinx Intelligent Cellular products while in control of a vehicle. Doing so will detract from the driver or operator's control and operation of that vehicle. In some states and provinces, operating such communications devices while in control of a vehicle is an offence.
Limitation of Liability
The information in this manual is subject to change without notice, and does not represent a commitment on the part of ProSoft Technology.
PROSOFT TECHNOLOGY, INC AND ITS AFFILIATES SPECIFICALLY DISCLAIM LIABILITY FOR ANY AND ALL DIRECT, INDIRECT, SPECIAL, GENERAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES INCLUDING, BUT NOT LIMITED TO, LOSS OF PROFITS OR REVENUE OR ANTICIPATED PROFITS OR REVENUE ARISING OUT OF THE USE OR INABILITY TO USE ANY PROSOFT TECHNOLOGY PRODUCT, EVEN IF PROSOFT TECHNOLOGY AND/OR ITS AFFILIATES HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR THEY ARE FORESEEABLE OR FOR CLAIMS BY ANY THIRD PARTY.
Notwithstanding the foregoing, in no event shall ProSoft Technology and/or its affiliates aggregate liability arising under or in connection with the ProSoft Technology product, regardless of the number of events, occurrences, or claims giving rise to liability, be in excess of the price paid by the purchaser for the ProSoft Technology product.
Patents
Portions of this product may be covered by some or all of the following US patents: 5,515,013 5,629,960 5,845,216 5,847,553 5,878,234 5,890,057 5,929,815 6,169,884 6,191,741 6,199,168 6,339,405 6,359,591 6,400,336 6,516,204 6,561,851 6,643,501 6,653,979 6,697,030 6,785,830 6,845,249 6,847,830 6,876,697 6,879,585 6,886,049 6,968,171 6,985,757 7,023,878 7,053,843 7,106,569 7,145,267 7,200,512 D442,170 D459,303
and other patents pending.
Your Feedback Please
We always want you to feel that you made the right decision to use our products. If you have suggestions, comments, compliments or complaints about the product, documentation or support, please write or call us.
ProSoft Technology 5201 Truxtun Ave., 3rd Floor Bakersfield, CA 93309 +1 (661) 716-5100 +1 (661) 716-5101 (Fax) www.prosoft-technology.com
Copyright © ProSoft Technology, Inc. 2009. All Rights Reserved. RLXIC-SG User Manual
May 29, 2009 ProSoft Technology ®, ProLinx ®, inRAx ®, ProTalk®, and RadioLinx ® are Registered Trademarks of ProSoft
Technology, Inc. All other brand or product names are or may be trademarks of, and are used to identify products and services of, their respective owners.
ProSoft Technology® Product Documentation
In an effort to conserve paper, ProSoft Technology no longer includes printed manuals with our product shipments. User Manuals, Datasheets, Sample Ladder Files, and Configuration Files are provided on the enclosed CD, and are available at no charge from our web site: www.prosoft-technology.com
Printed documentation is available for purchase. Contact ProSoft Technology for pricing and availability. Asia Pacific: +603.7724.2080
Europe, Middle East, Africa: +33 (0) 5.3436.87.20 Latin America: +1.281.298.9109 North America: +1.661.716.5100
Contents RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
Contents
Important Notice..................................................................................................................................2
Safety and Hazards ............................................................................................................................2
Limitation of Liability............................................................................................................................2
Patents................................................................................................................................................3
Your Feedback Please........................................................................................................................3
ProSoft Technology® Product Documentation...................................................................................3
1 Introduction to the RLXIC-SG 7
1.1 ALEOS™...................................................................................................................7
1.2 AceWare™................................................................................................................8
1.3 Connecting to your cellular provider..........................................................................9
1.4 GSM ........................................................................................................................11
2 Specifications 13
2.2 Interface Port Pin-Outs............................................................................................15
2.3 Power Connector.....................................................................................................15
3 Activating RLXIC-SG on your cellular provider 17
3.1 Installing the SIM.....................................................................................................17
3.2 Configuring the APN................................................................................................19
4 Hardware Installation of the RLXIC-SG 23
4.1 Connecting to Power...............................................................................................24
4.2 Connecting to a Computer or other Device.............................................................25
4.3 Indicator Lights........................................................................................................25
4.4 Mounting..................................................................................................................26
5 Configuring your RLXIC-SG 29
5.1 Using AceManager..................................................................................................29
5.2 Using Templates .....................................................................................................32
5.3 Using a Terminal Application with AT Commands..................................................36
6 Universal Serial Bus (USB) 41
6.1 Changing the USB port communication..................................................................41
6.2 Installing the USB driver..........................................................................................42
6.3 Using the Virtual Ethernet Port................................................................................49
6.4 Using the Virtual Serial Port....................................................................................50
7 Data Communication and Host Modes 51
7.2 Basic Modes............................................................................................................52
ProSoft Technology, Inc. Page 5 of 136 May 29, 2009
RLXIC-SG ♦ Intelligent Cellular Contents RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
7.3 Serial Modes........................................................................................................... 55
7.4 Data Communication.............................................................................................. 60
7.5 Keepalive................................................................................................................ 65
8 IP Manager 67
8.2 Understanding Domain Names............................................................................... 68
8.3 Dynamic Names ..................................................................................................... 69
8.4 Using IP Manager with your RLXIC-SG ................................................................. 69
8.5 Understanding DNS................................................................................................ 71
9 Configuring Modbus/BSAP 73
9.1 Modbus Overview................................................................................................... 73
9.2 Configuring the RLXIC-SG at the Polling Host for Modbus on UDP...................... 75
9.3 Configuring the Remote RLXIC-SGs for Modbus with UDP................................... 77
10 SNMP : Simple Network Management Protocol 81
10.2 SNMP Configuration............................................................................................... 82
10.3 SNMP MIB Definition Sample................................................................................. 84
11 Configuration Commands 89
11.1 Info (information)..................................................................................................... 89
11.2 Status...................................................................................................................... 91
11.3 Common .................................................................................................................93
11.4 Logging................................................................................................................. 120
11.5 Telemetry/Addr List............................................................................................... 121
11.6 Edge/HSDPA........................................................................................................ 123
12 Support, Service & Warranty 125
12.1 How to Contact Us: Technical Support................................................................. 125
12.2 Return Material Authorization (RMA) Policies and Conditions............................. 126
12.3 LIMITED WARRANTY.......................................................................................... 127
Index 133
Page 6 of 136 ProSoft Technology, Inc. May 29, 2009
Introduction to the RLXIC-SG RLXIC-SG Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
1 Introduction to the RLXIC-SG
In This Chapter
ALEOS™.................................................................................................7
AceWare™..............................................................................................8
Connecting to your cellular provider........................................................9
GSM......................................................................................................11
Powered by ALEOS™, RLXIC-SG modems are designed to maintain a reliable, consistent network connection. With a serial interface and a vast library of machine protocols, the RLXIC-SG is a workhorse for industrial and mission critical applications. Class I Division 2 certified as nonincendive equipment, the RLXIC Series is ideally suited for use in hazardous environments.
Key applications include utilities, manufacturing, automation, oil and gas, SCADA, telemetry, Homeland Security, and asset monitoring.
1.1 ALEOS™
ALEOS, the embedded core technology of the RadioLinx Intelligent Cellular products, simplifies installation, operation and maintenance of any solution, and provides an always-on, always-aware intelligent connection for mission-critical applications. ALEOS enables:
Persistent Network Connectivity Over-The-Air (OTA) Upgrades Wireless Optimized TCP/IP Real-Time Notification
ProSoft Technology, Inc. Page 7 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Introduction to the RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Extensive Machine Protocols Packet Level Diagnostics Device Management & Control Protocol Spoofing
1.2 AceWare™
A wireless solution is not complete until you have software tools to manage the devices monitoring your valuable equipment. AceWare™ is the device management and monitoring application suite for RadioLinx Intelligent Cellular products powered by ALEOS.
These modem utilities, except AceNet, are free of charge to those who own Intelligent Cellular modems. You can download the applications and their user guides from the ProSoft Solutions web site: www.prosoft-technology.com. Contact your dealer or ProSoft Technology representative for information on AceNet.
AceManager, the AceWare remote configuration and monitoring tool, simplifies deployment, and provides extensive monitoring, control and management capabilities. AceManager gives you the power to monitor and control your RadioLinx communications platforms in real time.
Simplified Deployment
AceManager provides the ability to remotely set up and configure your RadioLinx Intelligent Cellular products. Remote device setup and configuration reduces the deployment timeline of your wireless solution, and provides a quicker path to ROI.
Templates allow you to easily configure other devices in your fleet with identical settings, ensuring a simple, accurate deployment.
Monitor and Control
AceManager allows an administrator to remotely monitor a modem's status, health, and configuration settings. The user interface displays signal strength, cell site information, byte counters, and error conditions, enabling you to locate any issues, and troubleshoot immediately.
AceManager enables remote configuration and parameter settings to be changed or reset instantly over the air, change a device's port configuration, IP address settings, and much more. After configuring one modem, use the template feature to copy that device configuration to other modems.
Tip: Configuration steps and examples in this guide use AceManager.
AceNet, the enterprise grade productivity enhancing tool, enables you to efficiently deploy, and monitor RadioLinx Intelligent Cellular products on a large scale.
Page 8 of 136 ProSoft Technology, Inc.
May 29, 2009
Introduction to the RLXIC-SG RLXIC-SG Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
Network Monitoring
AceNet allows you to efficiently deploy, monitor, and maintain wireless networks of any size by enabling you to quickly configure an entire group of RadioLinx modems to the same parameter settings using templates built with AceManager.
To ensure your implementation is optimal, users can easily see when modems are out of contact, and periodically poll each device for performance statistics.
AceView is an efficient status and connection monitoring application with a low­profile, easy to read interface.
1.2.1 Modem Doctor
Modem Doctor is a troubleshooting and diagnostics utility. This utility will allow you to get a log file of the RLXIC-SG activity which you can then send to ProSoft Technology support, erase the current configuration completely, and temporarily set the RLXIC-SG to a known configuration to aid in trouble shooting (SOS mode).
1.3 Connecting to your cellular provider
The RLXIC-SG uses your cellular provider as an ISP (Internet Service Provider) to connect you to the Internet.
1.3.1 Steps of a connection:
1 When your RLXIC-SG is powered on, it automatically searches for cellular
service using GSM/GPRS.
2 Your RLXIC-SG establishes a PPP (Point to Point Protocol or "dial" up
connection) link to the your cellular provider network, also called registering on the network, and receives an IP address.
ProSoft Technology, Inc. Page 9 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Introduction to the RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
3 When your RLXIC-SG has received its IP address from your cellular provider,
a connection to the Internet or the cellular network is also available for a computer or other device connected directly to the RLXIC-SG.
The RLXIC-SG will perform a one-to-one routing for all internet traffic to and from the computer or other end device. One-to-one means that your RLXIC-SG will provide a connection for one device to the Internet at a time. In Private Mode, the RLXIC-SG will provide NAT (Network Address Translation) for the computer or other end device.
Note: The RLXIC-SG does not provide advanced routing required by one-to-many (several devices connected to one port). If you need to have more than one device connected to the Internet through your RLXIC-SG, you will need to have a router connected to the modem. The modem would provide the one-to-one connection to the router with the router configured to provide a broader NAT service to the other devices connected to it.
1.3.2 Dynamic vs. Static IP Addresses
There are two types of addresses on networks: dynamic and static. Dynamic addresses are assigned on a "need to have" basis. Your RLXIC-SG
might not always receive the same address each time it connects with your cellular provider.
Static addresses are permanently assigned to a particular account, and will
always be used whenever your RLXIC-SG connects to the Internet. The IP address will not be given to anyone else.
Most ISPs (cellular included) use dynamic IP addresses rather than static IP addresses, because it allows them to reuse a smaller number of IP addresses for a large number of customers. A dynamic IP address is suitable for many common Internet uses, such as web browsing, looking up data on another computer system, or other client functions (such as data only being sent out or only being received after an initial request).
Tip: If your account with your cellular provider includes a dynamic IP address, and you need a static IP, please consult your cellular provider Representative for more information about changing your account for static IP support.
Page 10 of 136 ProSoft Technology, Inc.
May 29, 2009
Introduction to the RLXIC-SG RLXIC-SG Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
If you need to contact your RLXIC-SG, a device connected to the RLXIC-SG, or a host system using the RLXIC-SG from the Internet, you need to have a known IP (such as one which is static) or domain name (an IP address which is converted by a DNS server into a word based name). If you have a dynamic IP address for your modem, you can use a Dynamic DNS service (such as IP Manager) to translate your IP address into to a domain name.
Caution: If you want to connect remotely to your RLXIC-SG using TCP/IP, the IP address given to your modem by your cellular provider cannot be a private or internal IP address (such as a custom APN or special private network Data Link) unless you are on the same network or inside that network's firewall (such as with frame relay).
1.4 GSM
GSM Networks use SIM cards which are smart cards containing the account holder's details. A SIM can generally be moved from one device to another allowing for account portability and flexibility.
1.4.1 GPRS
General Packet Radio Service (GPRS) is packet-switched with many users sharing the same transmission channel, but only transmitting when they have data to send. This means that the total available bandwidth can be immediately dedicated to those users who are actually sending at any given moment, providing higher utilization where users only send or receive data intermittently. GPRS provides speeds of 30- to 70 kbps with bursts up to 170 kbps.
ProSoft Technology, Inc. Page 11 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Introduction to the RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Page 12 of 136 ProSoft Technology, Inc.
May 29, 2009
Specifications RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
2 Specifications
In This Chapter
Interface Port Pin-Outs..........................................................................15
Power Connector...................................................................................15
2.1.1 Features and Benefits
Embedded Intelligence Low Power Consumption High-Speed Processor High-Speed 2-way Data Serial and USB Port Machine Protocols Simple Integration with Legacy Equipment Persistent Network Connectivity Remote Management and Configuration Suitable for use in Class I, Division 2, Groups A, B, C, D or unclassified or
non-hazardous locations
2.1.2 Technology
GPRS (MS-12)
With Fallback to:
o GSM
2.1.3 Bands
Quad Band GSM/GPRS/EDGE
o 850/900/1800/1900 MHz
2.1.4 Environmental
Operating Temperature:
o -30° to 70° Celsius
Storage Temperature:
o -40° to 85° Celsius
ProSoft Technology, Inc. Page 13 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Specifications RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
2.1.5 Power Consumption: (@12V DC)
Transmit/Receive (Typical/Max) 350/450 mA Idle 104 mA Input Current 40 mA to 120 mA Input Voltage 9 - 28V DC
2.1.6 Standards/Approvals
Carrier specific approvals FCC Industry Canada
2.1.7 Host Interfaces
USB Type B 5 Pin mini Antenna Connection:
o Cellular - 50 Ohm SMA
Warning: The antenna should be installed no closer than 20 cm from the human body. It is one of the RSS-102 requirements for devices not requiring SAR.
2.1.8 Dimensions
76mm x 25mm x 92mm 160 grams
2.1.9 Application Interfaces
TCP/IP, UDP/IP, DHCP, HTTP, SNMP, SMTP, SMS, MSCI, Binary, Modbus,
and more
2.1.10 LED Indicators
Network Signal Activity Power
Page 14 of 136 ProSoft Technology, Inc.
May 29, 2009
Specifications RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
2.2 Interface Port Pin-Outs
2.2.1 Serial Port
2.3 Power Connector
Warning: Explosion Hazard - Do not disconnect equipment unless power has been switched off or the area is known to be non-hazardous.
ProSoft Technology, Inc. Page 15 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Specifications RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Page 16 of 136 ProSoft Technology, Inc.
May 29, 2009
Activating RLXIC-SG on your cellular provider RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
3 Activating RLXIC-SG on your cellular provider
In This Chapter
Installing the SIM...................................................................................17
Configuring the APN..............................................................................19
This chapter provides step-by-step directions for activating your RLXIC-SG on your cellular provider's network.
3.1 Installing the SIM
The Subscriber Identity Module (SIM) in the RLXIC-SG is a smartcard that securely stores the key identifying a cellular subscriber. Generally, you will only need to install a SIM once in the life of the modem, and it may be pre-installed by your ProSoft Technology Representative.
3.1.1 Before you start
If the SIM was pre-installed, activation of your modem is complete.
Cellular Account Required
Cellular Account Required - To use your modem, you need to have an
active account with a data plan.
Software Required
AceManager - Graphical interface for entering most AT Commands. You can
download AceManager from the ProSoft Technology website: www.prosoft­technology.com. A default installation of this utility is assumed later in these directions
Hardware Required
Serial cable - A straight through serial cable.
OR
USB cable - A USB 2.0 A/Mini-B Cable
Note: Until you install a driver for the USB port, you cannot use your USB port to configure the modem.
Power adapter and a power source - You will need a power supply and
power source for the modem.
PC or laptop - To configure the modem, you will need a computer with an
available serial or USB port.
ProSoft Technology, Inc. Page 17 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Activating RLXIC-SG on your cellular provider RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Tools Required
Small Phillips screw driver - The Phillips screw driver is the one which is
also called a plus (+) or X screw driver.
3.1.2 Opening the Case
1 Unplug the RLXIC-SG power and all cables. 2 Using a small Phillips head screw driver, remove the screws on the front of
the RLXIC-SG.
3.1.3 Remove the SIM from the card
1 Carefully remove the SIM card from the card you received from your cellular
provider.
3.1.4 Insert the SIM
1 Gently press the SIM card to secure in place.
Note: The card and SIM may be a different color than these examples.
2 Gently press the SIM to click it into place.
Tip: The top of the card faces the bottom of the modem.
3.1.5 Finishing the SIM installation
When the faceplate is replaced and secured, the installation of the SIM is complete.
Page 18 of 136 ProSoft Technology, Inc.
May 29, 2009
Activating RLXIC-SG on your cellular provider RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
3.2 Configuring the APN
The APN (Access Point Name) is the way your modem knows how it will be communicating with the network. The APN allows custom IP addressing and tailoring your company's wireless IP solution to meet the security and IP addressing requirements of your applications.
Note: Most accounts use the default addressing solution of Private or Public IP addresses supplied by the Internet and Proxy APNs. Only if you have a Static or Custom IP address should you need to configure a custom APNs.
The default APN is Internet. If you need a different APN, use AceManager to configure it.
3.2.1 Start AceManager
START > ALL PROGRAMS > AIRLINKCOMMUNICATIONS > ACEMANAGER > ACEMANAGER
3.2.2 Connect to the Modem
1 Click the CONNECT button.
ProSoft Technology, Inc. Page 19 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Activating RLXIC-SG on your cellular provider RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
2 Select TCP, UDP, or PPP.
Enter the connection information.
o For UDP or TCP, enter 192.168.13.31 as the IP address. o For PPP, select the COM port to which the modem is connected.
Note: The simplest way to connect to the modem is through a USB cable. Refer to Universal Serial Bus (USB) (page 41) for information on how to install the necessary drivers for a USB connection.
3 Enter the password. The default password will be entered for you. 4 Click OK.
3.2.3 Enter the APN
1 Select GPRS from the menu on the left side of AceManager (under "Groups")
2 Type your APN in the New Value field of *NETAPN.
Optional: If you need to configure your modem for a custom APN, after entering the APN, there is additional information you will need to enter.
Page 20 of 136 ProSoft Technology, Inc.
May 29, 2009
Activating RLXIC-SG on your cellular provider RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
3 Select M
ISC from the menu on the left side under the Common group.
4 Enter the NAI into the new value field for *NETUID, and enter your network
password into the new value field for *NETPW.
3.2.4 Write the Settings to the RLXIC-SG
1 Click the Write button on the tool bar of AceManager.
2 Wait for the message "Write Successful" to appear in the status bar. 3 Reset the RLXIC-SG.
ProSoft Technology, Inc. Page 21 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Activating RLXIC-SG on your cellular provider RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Page 22 of 136 ProSoft Technology, Inc.
May 29, 2009
Hardware Installation of the RLXIC-SG RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
4 Hardware Installation of the RLXIC-SG
In This Chapter
Connecting to Power.............................................................................24
Connecting to a Computer or other Device ...........................................25
Indicator Lights......................................................................................25
Mounting................................................................................................26
Note: During installation, please be sure that the cables are secure but do not bear any additional weight that could loosen the connector from the unit.
Your RLXIC-SG should be mounted in a position that allows easy access for the cables so they are not bent, constricted, in close proximity to high amperage, or exposed to extreme temperatures. The LEDs on the front panel should be visible for ease of operational verification. You should ensure that there is adequate airflow around the modem but that it is kept free from direct exposure to the elements, such as sun, rain, dust, etc.
Caution: The RLXIC-SG is in a hardened case, and designed for use in industrial and extreme environments. However, unless you are using cables expressly designed for such environments, they can fail if exposed to the same conditions the RLXIC-SG can withstand. Note: This device is not intended for use within close proximity of the human body. Antenna installation should provide for at least a 20 CM separation from the operator.
ProSoft Technology, Inc. Page 23 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Hardware Installation of the RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Antennas selected should not exceed a maximum gain of 5 dBi under standard installation configuration. In more complex installations (such as those requiring long lengths of cable, and/or multiple connections), it is imperative that the installer follow maximum dBi gain guidelines in accordance with the radio communications regulations of the Federal Communications Commission (FCC), Industry Canada, or your country's regulatory body (if used outside the US).
Your RLXIC-SG will work with most cellular antennas with a SMA connector. Connect the primary antenna or primary RF cable directly to the antenna connector on the back of the RLXIC-SG.
Tip: When using a cable to an antenna placed away from the modem, minimize the length of your cable. All gain from a more advantageous antenna placement can be lost with a long cable to the modem.
4.1 Connecting to Power
This I/O port handles external input and output events. An external device can send digital input to the modem, through the digital I/O port.
Your RLXIC-SG can be used with either DC or AC, with the appropriate power adapter. DC cables and AC adapters are available as optional accessories in addition to the one included with your RLXIC-SG.
The color wires are: BLACK
(2 conductor) = Ground
RED (1 conductor) = Power
Note: When using a DC power source (such as a solar cell), ProSoft Technology recommends placing a fuse (1-2 Amp) on the line close to the power source to protect your power source from possible surges due to shorts or other line issues.
The DC power cable positive lead should be connected to the battery or power source positive terminal. The power cable negative lead should be connected to the battery or power source negative terminal.
Tip: The DC power cable has a white wire lead in addition to the power positive and negative. This is for a feature not present in the RLXIC line modems. In the RLXIC-SG, the white wire lead has no function and can be ignored.
Page 24 of 136 ProSoft Technology, Inc.
May 29, 2009
Hardware Installation of the RLXIC-SG RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
Warning: Explosion Hazard - Do not disconnect equipment unless power has been switched off or the area is known to be non-hazardous.
4.2 Connecting to a Computer or other Device
Your RLXIC-SG's full-speed (12 Mbit) USB 2.0 port can be connected directly to most computers or other devices using a standard full-speed USB 2.0 cable. If the computer or device you are connecting or the cable is not rated for full-speed, the modem will communicate at a reduced speed to match. The RLXIC-SG functions as a device, not a host.
When it is connected to a computer, the USB port should be seen as a COM port or Ethernet port after the applicable driver is installed.
The RLXIC-SG has a standard mini-B connector.
Warning: The USB port can only be used in a non-hazardous environment.
4.3 Indicator Lights
When your RLXIC-SG is connected to power and an antenna, there is a specific pattern to the lights to indicate its operation mode.
Network - Indicates a successful connection
to the cellular network with an IP address given, and a channel acquired.
Signal - Light shows the strength of the
signal, and may be nearly solid (strong signal) or flashing (weaker signal). A slow flash indicates a very weak signal.
4.3.1 RSSI LED Ranges
RSSI/Signal LED Status Ranges of RSSI (dBm)
On Solid Equal to or stronger than -69 Fast Blink -70 to -79 Normal blink -80 to -89 Slow Blink -90 to -99 Extinguished Equal to or weaker than -100
Activity - Lights will flash as data is transferred to and from the RLXIC-SG
modem on the remote network.
Power - Indicates the power adapter is connected, and there is power getting
to the RLXIC-SG.
ProSoft Technology, Inc. Page 25 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Hardware Installation of the RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
The Reset button (on the left side of the RLXIC-SG) has two functions. If it is
quickly depressed and released, the modem will simply power cycle the internal hardware. If, however, the reset is depressed and h seconds (co
unt 45 slowly, and wait for the power light to go off after the light
eld for 45
pattern stops), the ALEOS configuration settings will return to the factory defaults.
4.3.2 Light Patterns
The LEDs on the front of the modem will respond in different patterns to indicate modem states.
Normal - Each LED, mentioned above, is lit as applicable.  Start up - The LEDs will cycle from left to right.  PassThru mode - Network and Signal LEDs will blink in tandem. The Activity
LED will blink when transmitting or receiving data.
SOS - The Network LED blinks.  Configuration Reset - The LEDs will cycle left to right, and then right to left 4
times.
Authentication Failure - The Network, Signal, and Activity LEDs blink every
2 seconds.
Data Retry - The Network, Signal, and Activity LEDs blink every 3 seconds.
4.4 Mounting
An optional accessory for your RLXIC-SG is a DIN-rail mounting kit, which includes a bracket. The bracket is designed to hold the modem in place on the DIN-rail.
To install the radio in the mounting kit, follow these steps. 1 Mount the bracket using number 6 screws. There are two holes each, to
fasten screws, and minimum of one hole each end is required for mounting bracket.
2 Position RLXIC-SG between Alignment ears. 3 Engage top groove in body of RLXIC-SG with two tabs. 4 Push on far side of RLXIC-SG in center so that it touches side of Bracket. 5 Press down and release when upper groove on far side of RLXIC-SG, aligns
with tabs.
6 Release to complete installation into mounting bracket. To remove, press on the two edges of the modem and the brackets, as pointed
by arrows in the diagram provided below. By doing this, the modem will snap out of the mounting bracket.
To mount the bracket on the DIN-rail, follow these steps 1 Position the mounting bracket on a 35 x 7.5mm DIN rail at a slight angle with
the hook on the left side of the bracket hooked into the right side of the unit on the left.
2 Rotate the bracket onto the DIN rail with the top of the rail hooked under the
lip on the rear of the bracket.
Page 26 of 136 ProSoft Technology, Inc.
May 29, 2009
Hardware Installation of the RLXIC-SG RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
3 Press the bracket down onto the DIN rail until flush. The locking tab snaps
into position and locks the bracket to the DIN rail.
4 If the bracket does not lock in place, use a screwdriver or similar device to
move the locking tab down, press the bracket flush with the DIN rail and release the locking tab to lock the bracket in place.
4.4.1 Optional Mounting Bracket
4.4.2 Mounting Bracket Installation
ProSoft Technology, Inc. Page 27 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Hardware Installation of the RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
4.4.3 Mounting Bracket Dimensions
Page 28 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuring your RLXIC-SG RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
5 Configuring your RLXIC-SG
In This Chapter
Using AceManager................................................................................29
Using Templates ...................................................................................32
Using a Terminal Application with AT Commands.................................36
With ALEOS as its "brain", the RLXIC-SG is a highly configurable device, more than just a "dumb" modem.
To configure your RLXIC-SG, you have two options. You can use the configuration and management applications of the AceWare suite or you can use a terminal emulator application such as HyperTerminal, PuTTY, or many others.
Because the AceWare applications are designed for ease of use, nearly all descriptions and screen shots of RLXIC-SG configuration in this guide and Application Notes are done with AceManager. In addition to the various chapters in this guide giving information and directions about using the features of your RLXIC-SG, the Configuration Commands appendix briefly describes all the commands available. To get a more expanded view of the other AceManager features, refer to the AceManager Guide.
Refer to Configuration Commands for a full listing of the available commands (page
89).
5.1 Using AceManager
AceManager is a free utility and is available on the product CD or can be downloaded from the ProSoft Technology website.
ProSoft Technology, Inc. Page 29 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring your RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
5.1.1 Start AceManager
START > ALL PROGRAMS > AIRLINK COMMUNICATIONS > ACEMANAGER
5.1.2 Connect to your RLXIC-SG
1 Click the CONNECT button.
2 Select a connection method:
o If you are connecting remotely, you can use UDP, TCP, or SMS. o If you are connecting locally with the modem connected directly to your
computer using a serial cable, you can use PPP.
o If you are connecting locally with the modem connected directly to your
computer using an Ethernet cable, you can use UDP, TCP, or Ethernet.
3 Enter the connection information.
o For UDP or TCP, if you are connecting locally, use the *HOSTPEERIP of
the modem to connect. The default for the *HOSTPEERIP is
192.168.13.31.
o For SMS, enter the phone number of the modem, and select your wireless
carrier.
o For PPP, select the COM port to which the modem is connected.
4 Enter the password. The default password will be entered for you. 5 Click OK.
Page 30 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuring your RLXIC-SG RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
5.1.3 Enter the configuration options
1 On the left side of AceManager is the GROUPS menu. Select the appropriate
group as needed or directed.
2 Enter your changes in the N
change or using the drop down menus.
3 The current configuration is shown in the V
EW VALUE column by typing in the desired
ALUE column.
5.1.4 Write the changes to the modem
1 Click the WRITE button on the tool bar of AceManager. 2 Wait for the message "Write Successful" to appear in the status bar.
Tip: Some configuration settings will require you to reset the modem before they will take effect. You can reset the modem by using the Reset button in AceManager or by using the reset button on the modem. You can also reset the modem by cycling the power.
ProSoft Technology, Inc. Page 31 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring your RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
5.2 Using Templates
If you have a modem configuration that works well for your needs, using AceManager, you can save that modem's configuration as a template, and then apply it to other RadioLinx modems.
5.2.1 Creating the Template with AceManager
1 Configure the "master" modem. 2 Click the C
the New Value column.
3 Remove settings that are specific to your "master" modem, or verify settings
are applicable to all your modems.
Note: Some of the configuration settings are specific to individual modems. You do not want to have those settings in your saved template otherwise the modems you configure with the template could cease to work with the cellular or local network.
OPY button on the tool bar to transfer all the configured settings to
o Cellular Technology specific settings (the SG group) o *MODEMNAME o *HOSTPRIVIP o *HOSTPEERIP o *HOSTUID o *HOSTPW
4 Click the S
AVE button on the toolbar.
Page 32 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuring your RLXIC-SG RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
5 Type in a file name that is descriptive of the template (so you can find it easily
later), and save it to a location on your computer.
5.2.2 Applying a Template to one modem with AceManager
You can use a template you created yourself, using the steps above, or a template provided by your RadioLinx representative or someone in your company who has set up a modem template. The template you wish to apply must be saved to your hard drive.
1 Load the template.
a Connect to the modem you want to configure using AceManager. b Click the L
c Select the template you have saved (you may need to change folders if
you saved it to a different location).
2 Verify the configuration settings.
Tip: After you load the template, it is best to go back over the AceManager groups to make sure all the settings are what you require.
OAD button on the toolbar.
ProSoft Technology, Inc. Page 33 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring your RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
3 Click the W
RITE button on the toolbar to write the configuration to the modem.
Wait for the "Write Successful" message.
4 Reset the modem.
Caution: Many of the configuration settings will not take effect until the modem has been reset. Tip: You can use common settings on one modem to configure those same settings on another
modem even of a different type. For example, you can use the serial settings of a modem (such as RLXIC-SG, SV) to configure the serial settings of a RLXIC-SG. Settings not applicable to the modem on which you are loading the template, will be discarded.
5.2.3 Optional: Applying one template to several modems simultaneously with AceNet
AceNet allows you to connect to and monitor several modems at the same time. For your convenience, you can also apply a single template to selected modems simultaneously.
Connecting to the modems with AceNet is covered in the AceNet User Guide.
Caution: When applying a template in AceNet, it is even more important to make sure there are no non-general settings in the template from the "master" modem.
Unlike AceManager, AceNet does not check the modem type before applying the template. Settings not applicable, such as a USB setting from a RLXIC-SG template being applied to a modem of a different type, are not read by the receiving modem. You will get a "partial success" status if all items in a template cannot be applied by the receiving modem.
1 Select modems to configure with the template.
Page 34 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuring your RLXIC-SG RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
Tip: Click on the first with your mouse, and, with the control button held down, click the additional modem.
2 Select the MODEM option in the tool bar, and then select APPLY ACEMANAGER
TEMPLATE.
3 Either type in the Template file name, or click browse, and select the template
file you want to apply (you may need to change folders).
4 Set the Retry Interval and check if you want to have the modems Reset when
the template has been applied.
ProSoft Technology, Inc. Page 35 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring your RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
5.3 Using a Terminal Application with AT Commands
You can access and configure your RLXIC-SG using a terminal application such as Microsoft HyperTerminal, PuTTY, or similar. The following directions are for HyperTerminal which is part of a standard installation of Windows XP.
TART > ALL PROGRAMS > ACCESSORIES > COMMUNICATIONS > HYPERTERMINAL
S
Choose a name and icon for your connection.
1 Choose a name for your connection, such as RLXIC-SG or R
ADIOLINX
SOLUTIONS. The name and icon are only for your own reference so you can
find the connection at a later date.
2 Click OK.
Connect To
1 Select TCP/IP
(WINSOCK) for the "Connect Using".
Page 36 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuring your RLXIC-SG RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
Note: You can also connect using the virtual USB serial port. Refer to Using the USB virtual serial port with a Terminal Emulation Utility (page 50) for more information on configuring and using the virtual serial port.
2 Type in 192.169.13.31 for Host Address. 3 Change the "Port Number" to
2332.
4 Click OK.
Port Settings (serial only)
1 Change or verify the settings:
o Bits per Second: 115200 (default) o Data Bits: 8 o Parity: None o Stop Bits: 1 o Flow Control: Hardware.
ProSoft Technology, Inc. Page 37 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring your RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Tip: If you have configured the RLXIC-SG for settings different than the defaults for Bits per Second, Data Bits, Parity, and/or Stop Bits, you will need to use your changed settings.
2 Click OK.
Connected
1 Type
AT and press ENTER. You should get a reply of "OK" or "0".
2 To see what you are typing as you type it, you will need to turn on the echo
and verbose mode. Type
3 If you get a reply of "
get a reply of "
0" or "ERROR", try entering the command again.
ATE1V1 and press ENTER.
OK", then you entered the command successfully. If you
5.3.1 AT Commands
When using a terminal application, you will need to manually type in each command.
For most commands, when you are entering them using a terminal
connection, you will need to preface the command with AT (exceptions are noted), that is,
Some commands have specific parameters while other commands will take
whatever you type.
Required variable parameters are denoted with italicized text, example, Dn.
The n is variable.
Acceptable parameters and/or specific formats are listed with each
command.
Most commands with parameters can be entered with ? to read the current
value (for example, changed).
Page 38 of 136 ProSoft Technology, Inc.
ATA which is listed as A.
AT&D? will respond with "2" if the default has not been
May 29, 2009
Configuring your RLXIC-SG RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
Optional parameters are denoted with square brackets [ ]. AT Commands are not case sensitive. A capital "E" is the same as a lower-
case "e".
When you are using a terminal connection, if you enter a command which is
recognized by the RLXIC-SG, it will respond with "OK". If the command is not recognized, the response will be "ERROR".
Those commands applicable only to certain model numbers of the RLXIC-SG
will be noted.
Caution: Symbols listed with commands, such as *, /, &, or ?, are part of the command and must be included. Commands with symbols other than * may require PassThru mode.
ProSoft Technology, Inc. Page 39 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring your RLXIC-SG RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Page 40 of 136 ProSoft Technology, Inc.
May 29, 2009
Universal Serial Bus (USB) RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
6 Universal Serial Bus (USB)
In This Chapter
Changing the USB port communication ................................................41
Installing the USB driver........................................................................42
Using the Virtual Ethernet Port..............................................................49
Using the Virtual Serial Port ..................................................................50
The RLXIC-SG is equipped with a USB port which increases the methods by which you can send and receive data. The USB port can be set to work as either an Ethernet port or a virtual serial port. A driver installation is required to use the USB port in either mode.
Note: It is recommended that you use a USB 2.0 cable with your RLXIC-SG and connect directly to your computer for best throughput.
6.1 Changing the USB port communication
The command to change the port configuration is *USBDEVICE, and it is in the USB group of AceManager.
By default, the port is set to work as a virtual Ethernet port (*USBDEVICE=1). To change the USB port to allow virtual serial port communication, disable the
Ethernet port emulation, set *USBDEVICE to 0.
Note: If you use a terminal connection with the USB port to change *USBDEVICE, the change is immediate. Your connection will be terminated after inputting the command.
ProSoft Technology, Inc. Page 41 of 136 May 29, 2009
RLXIC-SG ♦ Intelligent Cellular Universal Serial Bus (USB) RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
6.2 Installing the USB driver
6.2.1 Set the Port Type
Virtual Ethernet port is the default setting for the USB port. If you want to install the virtual serial port, change the USB port configuration using the directions above.
6.2.2 Connect the RLXIC-SG to your computer's USB port
When you connect the RLXIC-SG for the first time to a USB port on your computer, Windows should detect a new device, and prompt you to install the driver.
Note: Windows will see each port type as a different USB device, and will see every port on your computer separately. If you change the port type on the RLXIC-SG or connect to a different USB port on your computer or hub, Windows will see it as a new device.
1 To start the install of the USB virtual Ethernet driver, select No, not this time,
and click Next.
2 Select Install from a list of specific location, and click Next.
Page 42 of 136 ProSoft Technology, Inc.
May 29, 2009
Universal Serial Bus (USB) RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
6.2.3 Install the driver from a specific location
1 Select and/or enter the location of the driver.
o If the driver is on the CD, and the CD is in your drive, you can just select
Search removable media.
o If you have installed AceManager or the Setup Wizard, the drivers have
been conveniently copied to your hard drive. Enter C:\Program Files\Common Files\AirLink as the location to search.
o If you will be installing the driver from a file downloaded from the ProSoft
Technology website, select Include this location in the search, and type in the location where you downloaded the file.
2 Click N
EXT.
After you select the location, the installation should begin. If you get a message asking if you want to continue the installation, click C
ANYWAY.
3 Click F
INISH to complete the installation. The driver should be enabled without
any need to reboot your computer.
ONTINUE
ProSoft Technology, Inc. Page 43 of 136 May 29, 2009
RLXIC-SG ♦ Intelligent Cellular Universal Serial Bus (USB) RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
6.2.4 Optional: Verify and Configure the Virtual Port Settings
Virtual Ethernet
The USB Ethernet connection will show up in your Network Connections as a Local Area Connection.
Tip: If you also have an Ethernet card on the computer or have installed the USB Ethernet to more than one USB port on your computer, the USB Ethernet may show up with a number.
You can also verify the installation by looking in the Device Manager.
1 Click on S 2 Double-click on the S
TART > CONTROL PANEL.
YSTEM icon.
Page 44 of 136 ProSoft Technology, Inc.
May 29, 2009
Universal Serial Bus (USB) RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
3 Select the H
ARDWARE tab, and click the DEVICE MANAGER button.
4 Click on the + in front of N
ETWORK ADAPTERS.
The newly installed driver, AirLink USB Ethernet/RNDIS, should be displayed. If the driver is displayed with a # and number behind the driver name (such as, AirLink USB Ethernet/RNDIS #2), it means more than one is installed on your computer, most likely for different USB port. More than one copy of the driver should not cause any problems, because only the connected port, and its driver, would be active.
ProSoft Technology, Inc. Page 45 of 136 May 29, 2009
RLXIC-SG ♦ Intelligent Cellular Universal Serial Bus (USB) RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Virtual Serial
You can verify the installation by looking in the Device Manager.
1 Click on S
TART > CONTROL PANEL.
2 Double-click on the S 3 Select the H
ARDWARE tab, and click the DEVICE MANAGER button.
YSTEM icon.
4 Click on the +
in front of MODEMS.
The newly installed driver, AirLink USB Serial Port, should be displayed.
Page 46 of 136 ProSoft Technology, Inc.
May 29, 2009
Universal Serial Bus (USB) RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
Tip: If the driver is displayed with a # and number behind the driver name (such as, AirLink USB Serial Port #2), it means more than one is installed on your computer, most likely for different USB port. More than one copy of the driver should not cause any problems, because only the connected port, and its driver would be active.
To connect to the modem using the USB virtual serial, most applications or utilities will require you to select or enter the serial (COM) port number. The USB connection will appear as a standard serial port, so you will need to determine its number to connect to it. The driver installation will automatically assign a port or you can change it if you wish to another unused port.
1 From the Device Manager, right click on the driver name, and select
Properties.
ProSoft Technology, Inc. Page 47 of 136 May 29, 2009
RLXIC-SG ♦ Intelligent Cellular Universal Serial Bus (USB) RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
2 Select the Advanced tab, and click the Advanced Port Settings button.
3 At the bottom of the screen, the current port used will be listed. Use the drop
down menu to select an available COM port number if you need to change it.
Page 48 of 136 ProSoft Technology, Inc.
May 29, 2009
Universal Serial Bus (USB) RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
6.3 Using the Virtual Ethernet Port
After the driver is installed, you can use the USB port just like a standard Ethernet port.
6.3.1 Using USB Ethernet with AceManager
In AceManager, use the UDP or TCP connection, and enter the IP address of the modem (
192.168.13.31 by default), and the password (12345 by default).
6.3.2 Using USB Ethernet with a Terminal Emulation Utility
Configure your terminal application for telnet communication.
1 In HyperTerminal, select TCP/IP (Winsock) 2 Use the IP address of the modem (
destination, and use the telnet port of the modem (
192.168.13.31 by default) as the 2332 by default).
3 Enter the modem password (
ProSoft Technology, Inc. Page 49 of 136 May 29, 2009
12345 by default) when requested.
RLXIC-SG ♦ Intelligent Cellular Universal Serial Bus (USB) RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
6.4 Using the Virtual Serial Port
After the driver is installed, you can use the USB port just like a standard serial port.
6.4.1 Using the USB virtual serial port with AceManager
In AceManager, the USB virtual serial port connection will appear as a standard serial port. Use the PPP connection, and select the COM# serial port of the USB connection.
Tip: You will need to open AceManager after you connect the USB cable to your computer for AceManager to have access to the USB Serial PORT.
6.4.2 Using the USB virtual serial port with a Terminal Emulation Utility
1 Select the serial port of the USB connection when prompted for a COM port. 2 Change the Bits per Second to 115200 (default), Data Bits to 8, Parity to
None, Stop Bits to 1, and Flow Control to Hardware.
3 You should also need to make sure your connection uses Auto Detect for the
terminal emulation.
Page 50 of 136 ProSoft Technology, Inc.
May 29, 2009
Data Communication and Host Modes RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
7 Data Communication and Host Modes
In This Chapter
Basic Modes ..........................................................................................52
Serial Modes ......................................................................................... 55
Data Communication.............................................................................60
Keepalive...............................................................................................65
Note: This section describes general communication options for the RLXIC-SG. For specific information regarding configuration of the RLXIC-SG for different industrial applications, refer to the application notes and templates on the RadioLinx CD.
The RLXIC-SG plays the part of a HOST when a computer or another device is connected directly to its port, and routes data to/from the connected device to the cellular network.
Tip: If you need to have one-to-many routing, you can connect the RLXIC-SG to a router. The router would provide the multiple routing, and the RLXIC-SG would provide one-to-one for the router to the cellular network and the Internet.
As the host, the RLXIC-SG can use different communication modes:
7.1.1 Basic Modes
AT: The RLXIC-SG accepts and responds to standard AT commands.  PassThru: Direct connection to internal hardware (OEM Module) of the
RLXIC-SG.
Telnet: The RLXIC-SG auto-answers TCP connections to allow terminal
emulation using either a local USB Ethernet connection or remotely using the cellular connection.
Tip: By default, the RLXIC-SG is in AT Mode, and allows AT Commands to be entered via terminal connection (through the local port connection) or remotely (through the cellular network). PassThru Mode can only be exited by resetting the RLXIC-SG. All serial modes are entered by use of a startup mode command.
ProSoft Technology, Inc. Page 51 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Data Communication and Host Modes RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
7.1.2 Serial Modes
PPP Mode: The RLXIC-SG uses PPP to communicate with a device or
computer connected to the serial or USB port.
SLIP Mode: The RLXIC-SG uses SLIP to communicate with a device or
computer connected to the serial or USB port.
UDP and UDP PAD: Any data received on the serial port is assembled into
UDP packets, and sent to the session's associated IP address and Port (described later). Any responses received from the associated IP address and port destined for the Device Port are unwrapped, and sent out the serial port.
TCP and TCP PAD: Any data received on the serial port is packaged into
TCP messages, and sent to the associated connection's IP address and Port (described later). Any data received from the TCP peer is unwrapped and sent out the serial.
7.1.3 Data Communication
Public and Private Modes: The method used by the RLXIC-SG to pass an
IP address to a connected device.
Keepalive: How the RLXIC-SG maintains its connection to the cellular
network.
7.2 Basic Modes
7.2.1 Start up Mode
The serial port of the RLXIC-SG can be configured to enter any of the modes automatically on power up (in most cases, this is also after it has registered on the cellular network). This is done by setting the Startup Mode Default to the desired mode. If this setting is non-zero, the modem will enter the specified mode after 5 seconds. If you want to cancel this behavior, the ATMD0 command can be used before the 5-second time-out expires.
You can configure the Startup Mode in AceManager at part of the UDP
group.
Page 52 of 136 ProSoft Technology, Inc.
May 29, 2009
Data Communication and Host Modes RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
If the serial port of the RLXIC-SG is in any mode other than AT or PassThru,
the AT command mode can be re-entered by:
Deactivating DTR (if &D2 or Ignore DTR, S211, is not set). Issuing the +++ escape sequence (if Disable AT Escape, DAE, is not set). Resetting or Power cycling the modem.
Note: DTR needs to be asserted (S211=1 or &D0) by the host before PPP Mode, SLIP Mode, UDP PAD Mode, or TCP PAD Mode can be entered.
7.2.2 AT Mode
Using a terminal connection, AT commands are used to configure the modem, command it to do something, or query a setting. For a full listing of the AT commands, refer to the appendix. AceManager is a graphical user interface for most AT Commands.
AT commands must always be terminated by <CR> (ASCII character 0x0D),
a carriage return (pressing enter on the keyboard). Some may also include a new line or line feed <LF>.
If E=1 (Echo On), the AT command (including the terminating <carriage
return) will be displayed (output) before any responses.
Two settings affect the format of AT command output: V (Verbose), and Q
(Quiet).
If Q=1 (Quiet On), no result codes are output whatsoever, so there is no
response generated by a (non query) command.
If Q=0 (Quiet Off), result codes are output. The format of this output is then
affected by the Verbose setting.
If Quiet mode is off, the result code is affected as follows: For V=1 (Verbose mode), the textual result code is surrounded by a carriage
return and new line. Any AT query response is also surrounded by a carriage return and new line.
For V=0 (Terse mode), a numeric result code is output with a single trailing carriage return (no new line is output), while any AT query response is followed by a carriage return and new line (there is no preceding output).
For example, possible output to the AT command "AT" with carriage return
(assuming quiet mode is not on) is: carriage return - if V=0
carriage return and new line OK another carriage return and new line - if V=1
Note: These commands work for the port on which they are executed. For example, if the user types ATE1, and then AT&W using a serial port connection, it will set the serial port to Echo On.
ProSoft Technology, Inc. Page 53 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Data Communication and Host Modes RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
7.2.3 PassThru Mode
In PassThru mode, the RLXIC-SG does not behave normally, all port communication is passed directly between the internal hardware and the computer connected directly to the modem. This mode can be used to configure hardware-specific settings. For example, provisioning, troubleshooting, communicating with legacy equipment, etc.
Caution: ALEOS is disabled in PassThru Mode. You cannot use most ALEOS specific commands while the modem is in PassThru Mode.
Issuing the "AT\APASSTHRU" from a terminal emulation enters this mode. The modem responds with OK, at which point a direct connection to the internal hardware is established. You can also configure the modem to enter PassThru mode on start up using MD.
Tip: PassThru can only be exited by resetting or power-cycling the modem. This mode cannot be entered via a remote Telnet session.
You can configure a string of AT commands to be sent to the RLXIC-SG when it enters PassThru, and other PassThru settings.
PassThru Mode allows only specific AT commands. Some ALEOS commands will be unavailable when the RLXIC-SG is in PassThru mode. The commands usable also depend heavily on the modem model number (found on the label on the top of the RLXIC-SG).
Note: Some internal hardware requires upwards of 20 seconds before AT commands can be entered, so be patient if there seems to be no response to AT commands.
Page 54 of 136 ProSoft Technology, Inc.
May 29, 2009
Data Communication and Host Modes RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
7.2.4 Telnet Mode
In AceManager you can configure Telnet operation.
If you need to change the port for Telnet (for example, you have the default port blocked on your firewall), the option is on the O
2332. You can also change the Telnet timeout, if the connection is idle, default
is 2 minutes.
THER tab. The default telnet port
7.3 Serial Modes
7.3.1 PPP
In PPP mode, the RLXIC-SG acts as a PPP server, providing an IP address, and DNS servers (if available) to the connected device or computer.
PPP mode is entered from the AT mode by using any of the following commands:
AT\APPP ATDT10.0.0.1 ATDT10001 ATD#19788 or #777 *99***1# CLIENT
ProSoft Technology, Inc. Page 55 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Data Communication and Host Modes RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
In response to any of the preceding commands, the RLXIC-SG will respond with CONNECT a carriage return and new line and is ready for the host to begin PPP negotiations. The IP received by the host in the resulting negotiation will either be a private (non-routable) IP address or a public (network-routable) IP address provided by the network, depending on the settings of *HOSTPRIVMODE. If *HOSTPRIVMODE=1, the value of the private IP address can be determined beforehand by querying S110. The private IP address to be used can be defined with the command AT*HOSTPRIVIP=192.168.100.33, substituting the desired IP address.
Using a private IP insulates the PPP client from changes in IP addresses of the underlying network. The will perform basic NAT-like address translation on all packets.
If a public IP address is being used, any changes in the IP (as determined by the wireless network) will result in the PPP link to the host being disconnected, requiring the host to reinitiate it. The public IP is passed to the host in the PPP negotiations, so when the network forces a change, the modem has to force the host to renegotiate the PPP link to make this happen.
7.3.2 SLIP
SLIP mode is entered be using the "AT\ASLIP" command. As in PPP Mode, the IP address that the host assumes is affected by the setting of *HOSTPRIVMODE. SLIP does not negotiate the IP address with the connected device or computer, so before making a SLIP connection, the SLIP driver on that device or computer must be configured to use the IP address specified by querying S110.
Page 56 of 136 ProSoft Technology, Inc.
May 29, 2009
Data Communication and Host Modes RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
When the modem is in UDP PAD (Packet Assembly and Disassembly) Mode,
all characters received on the serial port are assembled into UDP packets, and sent to the remote IP address/port or the RLXIC-SG, and any packets received from the same IP/port-destined for the device port of RLXIC-SG (see *DPORT)--are disassembled, and dumped onto the serial line.
A UDP session is initiated by one of the following events:
Using the Dial UDP (DP) AT command (example, ATDP192.168.3.23/3456). Setting the Startup Mode Default (MD) to 3 (UDP) so that a UDP session is
entered automatically when the modem registers onto the network. Serial data will be sent to the IP/port specified in S53.
Incoming UDP packets will be processed out the serial port if
UDP auto answer is enabled (S82=2); The destination IP address matches that in S53 (if Friends Mode is enabled,
the IP address also needs to be present on the Friends List);
Or allow any IP is set (AIP=1); The modem is in AT mode (not in a current UDP or TCP session).
UDP packet assembly is affected by the values of S50 (PAD Forwarding Time­out) and S51 (PAD Forwarding Character). Data received in the serial buffer will be transmitted when the idle inter-character time-out specified in S50 (in tenths of seconds) occurs or when a character is received that matches S51 (if non-zero).
7.3.3 UDP Auto Answer
UDP auto answer (previously called UDP half-open) is set with S82=2. When set, the RLXIC-SG will automatically establish a UDP session to the source IP address, and port of the UDP packet received. The RLXIC-SG will remain "locked" to this one remote IP/port until no data is sent or received for the time interval defined in the UDP auto answer time-out (S83). During this session, packets from other IP/port addresses will be rejected, unless *UALL is set. Whether or not an incoming packet will cause the modem to enter a UDP session is always dependent on the S53 and AIP settings.
The Normal UDP Mode (MD3) can be combined with UDP auto answer to cause the incoming serial data to be sent in UDP packets (instead of being treated as AT commands), while allowing sessions to be established from different UDP sources. A UDP session will be initiated either by incoming serial data or by an incoming UDP packet. The session, started by either method, will be terminated when no data has been sent or received for the S82 period. After the session terminates, another may be initiated by either means.
When idle, after the time-out has occurred, the modem is in AT command mode on the serial port, and any valid AT command may be entered during this time.
Tip: It is best to ensure the idle time-outs for TCP and UDP are never 0 if you're going to be using auto-answer, or either PAD mode. In those circumstances, you will want the modem to close the socket if the connection goes idle for too long, particularly if the other side does not normally close the connection.
ProSoft Technology, Inc. Page 57 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Data Communication and Host Modes RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
When the session is initiated by serial data, the new session will be established using the destination address specified in S53. The S53 setting can be changed if the connect to last UDP setting (*UDPLAST=1) is set. The address in S53 will be updated to reflect the address of the last session initiated by an incoming UDP packet. So that when new data is received over the host serial port while in the idle state, a session will be re-established with the last address. (This behavior is the same as the previous Hybrid2 (MD6) mode).
Tip: TCP auto answer (S0) may also be set simultaneously with UDP auto answer. Then, when in the idle state, the modem will accept either a TCP or UDP incoming packet, and enter a TCP or UDP session as appropriate.
Reliable UDP
Reliable UDP adds a simple protocol on top of UDP to provide reliable delivery of data. When data is received from the host serial port, a 2 byte header is added to the data, containing a message type and a sequence number. The RLXIC-SG will continue to send this data (buffering any received data in the meantime) until it receives an acknowledgement with this sequence number. If an acknowledgement is not received within the time-out period (specified in S7), the data will be retransmitted. This will continue until an acknowledgement is received or the modem is reset. Likewise any UDP packets received by the RLXIC-SG are expected to have this simple header. The RLXIC-SG will issue an acknowledgement for any valid packets which are received.
To configure the RLXIC-SG for a normal UDP session, you need to set the Startup Mode Default to 73 (ATMD73). If you are using two modems, configure the Destination IP and Port in each to point to each other. Serial data will then be sent reliably between the two.
Caution: Although it adds reliability, the simple implementation of the Reliable UDP mode in the RLXIC-SG does not check for duplicate packets.
UDP Multicast Mode
UDP Multicast mode results in any data received from the host serial port being sent to all the clients in the address list. The remote port number is taken from S53. To avoid flooding the network, the packets are sent to each client with a 20ms pause in between. The receipt of UDP packets works as in normal UDP mode (that is, bound by the value S53 and/or AIP). Because it may take a while to transmit the data to all hosts (especially if all 20 Modbus entries are used and name resolutions are required), new data received from the host port is buffered until current transmissions to all hosts are finished.
Enter the list of target IPs in the address list (ADDR LIST). The index numbers in the list are not used. Configure for a normal UDP session. Set the Startup Mode Default to 83 (ATMD83). Configure the Destination port to match the device port of the remote modems.
Page 58 of 136 ProSoft Technology, Inc.
May 29, 2009
Data Communication and Host Modes RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
7.3.4 TCP and TCP Pad
When the RLXIC-SG is in a TCP session, all characters received on the serial port are assembled into TCP packets, and sent to the mode's remote IP address/port, and any packets received from the remote end of the TCP connection are disassembled, and dumped onto the serial line.
A TCP connection is established by one of the following methods: Using the Dial TCP (DT) AT command. For example,
ATDT192.168.3.23/3456.
TCP auto answer is enabled (S1), a TCP connection request is received, and
the modem is not in a data session.
Data is received on the serial port, and
o The Startup Mode Default (MD) is 4 (auto TCP) o The remote TCP destination, as defined in S53, successfully responds to
the TCP connection request.
The value of S7 (TCP Connection Time-out) specifies the number of seconds to wait, after initiating a TCP connection attempt, for a successful connection to be established. If the connection has not been successfully established before the time-out occurs, ERROR/BUSY is returned.
TCP packet assembly is affected by the values of S50 (PAD Forwarding Time­out) and S51 (PAD Forwarding Character). Data received in the serial buffer will be transmitted when the idle inter-character time-out specified in S50 (in tenths of seconds) occurs or when a character is received that matches S51 (if non-zero).
The TCP session will be terminated if no data is transmitted or received for the time interval specified in TCPT and TCPS. TCPT is the number of minutes (TCPS=0) or seconds (TCPS=1) used for this idle time-out.
Caution: TCPT should never be 0 when using the TCP mode. A broken TCP session can result in the modem being left with a TCP Auto Answer
TCP auto answer (S0=1|2) also allows a TCP connection request to be "answered" when the modem is idle, not in a data session. The TCP connection request's destination port has to match the modem's device port.
Note: UDP auto answer may also be set simultaneously with TCP auto answer. Then, when in the idle state, the modem will accept either a TCP connection request or UDP incoming packet, and enter a TCP or UDP session as appropriate.
7.3.5 Hybrid Mode
Hybrid modes are supported mainly for legacy implementations. Some previous hybrid modes (MD=5, 6) are no longer implemented as special, unique modes. Now that UDP auto answer (UDP Half-open, S82=2) can be enabled in conjunction with UDP PAD mode (MD3), effectively this is the same as MD5 and MD6 previously accomplished. Setting MD5 and MD6 are still supported, but not recommended.
ProSoft Technology, Inc. Page 59 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Data Communication and Host Modes RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
AT Command Hybrid Mode (MD5) Hybrid Mode2 (MD6)
MD 3 3 S82 2 2 S0 1 1 *UDPLAST 0 1
7.4 Data Communication
Note: The RLXIC-SG forwards messages to and from the cellular network for only ONE device per port. The RLXIC-SG is a one-to-one gateway, and does not have advanced routing features required to do one-to-many routing.
The primary purpose of the RLXIC-SG is to forward data from a single device connected to one of the ports to the cellular network, and, ultimately, under most circumstances, to the Internet in a one-to-one gateway configuration.
When the RLXIC-SG obtains its IP address from your cellular provider, it also obtains the network routing information necessary to forward messages to their routers which can then forward on from there. The RLXIC-SG then acts as a router for the device connected to it, forwarding to or from the cellular network.
Note: If you have a device connected to the serial port and the USB port, they will not be able to communicate to each other. Each port is routed separately to the cellular network with one-to-one routing for each.
7.4.1 Public and Private Mode
In Public Mode, the RLXIC-SG will pass the IP address assigned by the cellular network to the device connected to its port. Public Mode is the default mode for the RLXIC-SG.
If you need more control over which gateway address, device address, and netmask that is given out by the internal DHCP server, you can use the private host mode, *HOSTPRIVMODE, and set the internal network IP addresses. The RLXIC-SG will use NAT to forward packets to the end device.
Tip: When using Public mode, ProSoft Technology recommends connecting the modem directly to the computer or other end device. Using a hub or switch may prevent the RLXIC-SG from updating the IP address of the end device when an IP address is received from the cellular network.
In AceManager, the Private mode settings are part of the PPP/Ethernet group.
Page 60 of 136 ProSoft Technology, Inc.
May 29, 2009
Data Communication and Host Modes RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
*HOSTPRIVMODE - Set to 1 to enable the explicit IP addresses.  *HOSTPRIVIP - Set to the IP address you want the RLXIC-SG to give to your
device.
DHCP network Mask - The subnet mask that is passed to the DHCP client
on the Host device.
*HOSTPEERIP - Set to the IP address you want for the RLXIC-SG.  *HOSTNETMASK - Set to the subnetmask, generally 255.255.255.0.
Tip: If you are using Private Mode (*HOSTPRIVMODE=1), you will need to make sure that *HOSTPRIVIP and *HOSTPEERIP are on the same subnet. If the subnet mask is 255.255.255.0, it is safe to use 192.168.x.y for each as long as the x is the same number (0 in the example screen shot above), and the y is different (1 and 2 in the example), and between 0 and 254. Note: Regardless if the RLXIC-SG is configured for Public Mode or Private Mode, the same IP address will be given to all devices connected to any of the ports. While you can connect with each to the cellular network and the Internet, you cannot use the RLXIC-SG as a hub or router to communicate between them.
Internal DHCP Server
DHCP (Dynamic Host Configuration Protocol) has become a primary component of today's network environments. DHCP allows one server to automatically and dynamically allocate network IP addresses, and other network related settings (such as subnet masks, routers, etc.) to each computer or device without the need to set up each specifically or keep track of what addresses have already been used.
In a default configuration, the RLXIC-SG acts as a DHCP host to any device connected to its ports, providing that device with an IP address which can be used to communicate on the Internet. In Public Mode, that will be the IP address assigned by the cellular network. In Private Mode, that will be the IP address defined in *HOSTPRIVIP.
1 When the RLXIC-SG registers on the cellular network, it is assigned an IP
address from your cellular provider, for example, 10.1.2.0.
2 Acting as a DHCP server, in Public Mode, when the RLXIC-SG receives a
DHCP request from an Ethernet device connected via USB, it hands off the assigned address to the device, and sets up the default gateway address as
10.1.2.1. If the fourth octet is already a 1, it assigns 10.1.2.2 as the router address.
3 The RLXIC-SG also sends a /24 netmask (255.255.255.0 by default), and
sets up a static route which maps 192.168.13.31 (or the address configured with *HOSTPEERIP if it is changed) to 10.1.2.1 (or 10.1.2.2 if that was what the gateway address was given as).
Tip: When PPPoE is used with the RLXIC-SG, DHCP is not needed. A tunnel is set up connecting a device (such as your computer or a router) with the modem. The device will then simply use the MAC address of the RLXIC-SG to send all outgoing packets.
ProSoft Technology, Inc. Page 61 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Data Communication and Host Modes RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Additional Connected Networks
If you have a router connected to the RLXIC-SG with additional networks configured behind that router, you can specify them in the PPP/Ethernet group of AceManager. Configure the Network the Host Network Mask for up to two additional networks.
7.4.2 Basic Routing
Expanding the capabilities of the RLXIC-SG, ALEOS features some basic routing to connected computers and networks.
Port Forwarding
Any data coming in on the defined Public Port will be passed to the corresponding Private Port connected to the physical interface specified and using the host IP address.
Note: This feature can be used only in private mode.
Page 62 of 136 ProSoft Technology, Inc.
May 29, 2009
Data Communication and Host Modes RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
In AceManager, enter the fields in the Port Forwarding group. Number of PF Entries: Set value to number of used Port forward rules for
performance gain. Each forwarding entry has four parameters:
o Public Port: Port number of the Modem/Gateway. o Host/IF: Physical connection type to the modem. (USB, Ethernet, Serial). o Host IP: IP address of the connected device/computer. o Private Port: Port number on the connected device.
You can set a default in the PPP/Ethernet group, if you do not need: To forward to specific ports on your connected device, but you want all data
to be directly used by ALEOS, or otherwise forwarded.
To pass to only one connected device.
Note: The default settings are independent of the number of Port Forward entries, and can be used with port forwarding to pass anything not forwarded to specific ports.
o Default Interface: Choose the Default Interface desired (that is, Ethernet
or USB or Serial).
o Default IP: Enter this option only when you want to forward ports not
specified, to the default IP.
Firewall Functions
The RLXIC-SG can provide a basic firewall between the public and private networks. There are two types of firewall rules supported by the RLXIC-SG, IP filtering and port filtering.
IP Filtering: When enabled, only packets with source IP addresses matching
those in a list or range of trusted hosts will be allowed through.
o Friends List IP: Each entry can be configured to allow a single IP address,
for example 64.100.100.2, or the IP addresses from a complete subnet, such as 64.100.10.255 allowing all IP addresses from 64.100.10.0 to
64.100.10.255.
o Non-Friends Port Forwarding: Non-Friends port forwarding is like an allow
rule for any of the forwarded ports. If it is enabled, the port forwarding rules apply to all incoming packets. If it is disabled, only Friends List IPs get through.
o Start and End Range: Specify the IP address range that is allowed
access, for example 64.100.10.2 to start and 64.100.10.15 to end would allow 64.100.10.5 but would not allow 64.100.10.16.
ProSoft Technology, Inc. Page 63 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Data Communication and Host Modes RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Note: Port Filtering Mode does not require to be set when you enable Non-Friends Port Forwarding.
Port Filtering Mode: Independent of the IP filtering, this mode can be
enabled to block ports specified or allow ports specified. When enabled, all ports not matching the rule will be allowed or blocked depending on the mode.
Firewall Port: Specify the port you wish to have blocked or allowed,
depending on the mode configured.
Packet Filtering: Not available at this time.
Page 64 of 136 ProSoft Technology, Inc.
May 29, 2009
Data Communication and Host Modes RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
7.5 Keepalive
Keepalive is used to test the connection to the cellular network by pinging an IP address after a specified period of inactivity. Keepalive is only recommended for users who have a remote terminated modem that infrequently communicates to the network or if you have experienced issues over time where the modem can no longer be reached remotely.
When Keepalive pings the IP address, an acknowledgement indicates there is an active connection to the network. If the RLXIC-SG does not receive a response from the IP address, it will make additional attempts according to a backoff algorithm before determining the Internet connection is not functioning properly. If it determines the connection is not functioning, the modem will then attempt to reconnect to your cellular provider to reestablish IP connectivity.
7.5.1 Configuring Keepalive
In AceManager, the Keepalive settings are part of the OTHER group.
*IPPING sets the interval, in minutes, you want Keepalive to test the network
connection. To disable Keepalive, set *IPPING to 0 (default setting).
Note: The minimum time which can be set for Keepalive is fifteen minutes. If you set *IPPING for a value less than the minimum, the minimum value will be set.
*IPPINGADDR sets the IP address you want to use for the connection test.
Caution: If *IPPINGADDR is left blank or is set to an invalid IP address (example, an IP which is unreachable or one which is not a valid IP address), modem performance will be adversely affected.
ProSoft Technology, Inc. Page 65 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Data Communication and Host Modes RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
7.5.2 Data usage using Keepalive
Keepalive is an optional feature. If you frequently pass data with your modem, you most likely do not need to have Keepalive enabled. When using Keepalive, be aware that a ping moves approximately 66 bytes of data over the network, and is billable by your cellular provider. The following *IPPING settings will incur approximate monthly data usage in addition to any other data usage:
Page 66 of 136 ProSoft Technology, Inc.
May 29, 2009
IP Manager RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
8 IP Manager
In This Chapter
Understanding Domain Names .............................................................68
Dynamic Names....................................................................................69
Using IP Manager with your RLXIC-SG ................................................ 69
Understanding DNS ..............................................................................71
If you have a fleet of RLXIC modems or even if you only have one, it can be difficult to keep track of the current IP addresses, especially if the addresses are not static but change every time the modems connect to Provider. If you need to connect to a modem, or the device behind it, it is so much easier when you have a domain name.
8.1.1 Reasons to contact the modem and/or the connected device:
Requesting a location update from a delivery truck. Contacting a surveillance camera to download logs or survey a specific area. An oil derrick that needs to be triggered to begin pumping. Sending text to be displayed by a road sign. Updating the songs to be played on a juke box. Updating advertisements to be displayed in a cab. Remote access to a computer, a PLC, an RTU, or other system. Monitoring and troubleshooting the status of the modem itself without needing
to bring it in or go out to it.
A dynamic IP address is suitable for many Internet activities such as web browsing, looking up data on another computer system, data only being sent out, or data only being received after an initial request (also called Mobile Originated). However, if you need to contact RLXIC-SG directly, a device connected to the modem, or a host system using your RLXIC-SG (also called Mobile Terminated), a dynamic IP will not give you a reliable address to contact (because it may have changed since the last time it was assigned).
Domain names are often only connected to static IP addresses because of the way most domain name (DNS) servers are set-up. Dynamic DNS servers require notification of IP Address changes so they can update their DNS records, and link a dynamic IP address to the correct name.
Dynamic IP addresses are granted only when your RLXIC-SG is connected,
and can change each time the modem reconnects to the network.
Static IP addresses are granted the same address every time your RLXIC-SG
is connected, and are not in use when your modem is not connected.
ProSoft Technology, Inc. Page 67 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular IP Manager RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Because many cellular providers, like wire-based ISPs, do not offer static IP addresses or static address accounts cost a premium vs. dynamic accounts, IP Manager works with a Dynamic DNS server to receive notification from RLXIC modems to translate the modem's dynamic IP address to a fully qualified domain name. Thus, you can contact your RLXIC-SG directly from the Internet using a domain name.
8.2 Understanding Domain Names
A domain name is a name of a server or device on the Internet which is associated with an IP address. Similar to how the street address of your house is one way to contact you and your phone number is another, both the IP address and the domain name can be used to contact a server or device on the Internet. While contacting you at your house address or with your phone number employ different methods, using a domain name instead of the IP address actually uses the same method, just a word based name is commonly easier to remember for most people than a string of numbers.
Understanding the parts of a domain name can help to understand how IP Manager works, and what you need to be able to configure the modem. A fully qualified domain name (FQDN) generally has several parts.
Top Level Domain (TLD): The TLD is the ending suffix for a domain name
(.com, .net, .org, etc.)
Country Code Top Level Domain (ccTLD): This suffix is often used after the
TLD for most countries except the US (.ca, .uk, .au, etc.)
Domain name: This is the name registered with ICANN (Internet Corporation
for Assigned Names and Numbers) or the registry for a the country of the ccTLD (that is, if a domain is part of the .ca TLD, it would be registered with the Canadian domain registry). It is necessary to have a name registered before it can be used.
Sub-domain or server name: A domain name can have many sub-domain
or server names associated with it. Sub-domains need to be registered with the domain, but do not need to be registered with ICANN or any other registry. It is the responsibility of a domain to keep track of its own subs.
server123.example.com
.com is the TLD
example is the domain (usually noted as example.com, because the domain is
specific to the TLD)
server123 is the subdomain or server name associated with the device,
computer, or modem registered with example.com.
server123.example.com.ca
This would be the same as above, but with the addition of the country code. In this example, the country code (.ca) is for Canada.
Page 68 of 136 ProSoft Technology, Inc.
May 29, 2009
IP Manager RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
Tip: A URL (Universal Resource Locator) is different from a domain name in that it also indicates information on the protocol used by a web browser to contact that address, such as www.prosoft­technology.com. www.prosoft-technology.com is a fully qualified domain name, but the http://, the protocol identifier, is what makes the whole thing a URL.
8.3 Dynamic Names
When an IP address is not expected to change, the DNS server can indicate to all queries that the address can be cached and not looked up for a long period of time. Dynamic DNS servers, conversely, have a short caching period for the domain information to prevent other Internet sites or queries from using the old information. Because the IP address of a modem with a dynamic account can change frequently, if the old information was used (such as with a DNS server which indicates the address can be cached for a long period of time) when the IP address changed, the domain would no longer point to the new and correct IP address of the modem.
If your RLXIC-SG is configured for Dynamic IP, when it first connects to the Internet, it sends a IP change notification to IP Manager. IP Manager will acknowledge the change, and update the Dynamic DNS server. The new IP address will then be the address for your modem's configured name.
After your modem's IP address has been updated in IP Manager, it can be contacted via name. If the IP address is needed, you can use the domain name to determine the IP address.
Note: The fully qualified domain name of your RLXIC-SG will be a subdomain of the domain used by the IP Manager server.
8.4 Using IP Manager with your RLXIC-SG
To allow your RadioLinx modem to be addressed by name, the modem needs to have a minimum of three elements configured. You can also configure a second dynamic server as a backup, secondary, or alternate server.
In AceManager, select D
YNAMIC IP.
ProSoft Technology, Inc. Page 69 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular IP Manager RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
*MODEMNAME : The name you want for the modem. There are some
restrictions listed below for the modem name.
*DOMAIN : The domain name to be used by the modem. This is the domain
name of the server configured for *IPMANAGER1.
*IPMANAGER1 : The IP address or domain name of the dynamic DNS
server which is running IP Manager.
*IPMANAGER2 : The secondary server for the domain. While it is optional to
have two servers configured, it is highly recommended.
Tip: You can use a domain name instead of the IP address for your IP Manager servers if you have DNS set up in your RLXIC-SG.
*IPMGRUPDATE1 and *IPMGRUPDATE2: How often, in minutes, you want
the address sent to IP Manager. If this is set to zero, the modem will only send an update if the IP address changes (example, if your RLXIC-SG is reset or is assigned a different IP address).
*IPMGRKEY1 and *IPMGRKEY2: User defined password key which is used
instead of RadioLinx secret key when using an IP Manager server other than the one provided by ProSoft Technology.
Restrictions for Modem Name
For the Modem Name, you should use something which is unique but also easy to remember. Your company name or the intended function of the modem are recommended. If you have more than one modem, and want to name them the same, you can append a number for each. Because it is an Internet domain name, there are some restrictions for the name.
Must begin with a letter or number Can include a hyphen (-) Cannot contain spaces Must be no longer than 20 characters total
8.4.1 Data Usage for IP Manager Server Updates
The IP Manager update is a small packet sent to the server with a response sent back to the modem. If you have *IPMGRUPDATE1 or *IPMGRUPDATE2 set to any number but zero, the modem will send the update not only when it receives a new IP address but at the time interval as well. The data traffic could be billed by your carrier.
Each update is a total of 68 bytes from the modem with a 50 byte total response from the server for a round trip update of 118 bytes.
interval (minutes) total bytes per day (24 hours)
10 16992 bytes 30 5664 bytes 60 2832 bytes 500 339.84 bytes
Page 70 of 136 ProSoft Technology, Inc.
May 29, 2009
IP Manager RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
8.4.2 Eairlink.com
As a service, ProSoft Technology offers an IP Manager server, which can be used for any RadioLinx Intelligent Cellular modem.
Note: The IP Manager service is currently not a guaranteed service, although every effort is made to keep it operational 24/7.
*DOMAIN : eairlink.com  *IPMANAGER1 : edns2.eairlink.com  *IPMANAGER2 : eairlink.com
Important: Because many modems use the IP Manager service, you must have a unique name for your modem.
8.5 Understanding DNS
The RLXIC-SG has the ability to query DNS servers in order to translate domain names into IP addresses. This allows you to use domain names in place of IP addresses for most of the configuration options requiring IP addresses. This is important if your RLXIC-SG will need to contact another modem or other device that has a domain name but an unknown or dynamic IP address (such as another remote RLXIC-SG using IP Manager).
8.5.1 Configuring DNS
Generally, when your RLXIC-SG receives its IP address from Provider as part of the connection process, it will also receive the DNS servers to use for resolving (or translating) names to IP addresses which it will automatically configure in the modem settings. Unless your RLXIC-SG will be used on a network with other modems or devices which have names internal to the local network or frequently changing IP addresses, the DNS servers provided by Provider should be all you need.
If the RLXIC-SG will be communicating with a device that has a domain name but changes its IP address frequently (such as another RadioLinx modem using IP Manager) or is on a network where devices are accessed by names rather than IP addresses, you will want to put in an alternate DNS (*DNSUSER) where that domain is updated, such as the IP Manager server the remote modem is using or the listing of IP addresses to names is kept.
If you need to manually configure DNS, in AceManager, select DNS.
ProSoft Technology, Inc. Page 71 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular IP Manager RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
*DNSUPDATE - This command sets how often you want DNS Updates to be
requested. Otherwise the RLXIC-SG will only send updates when it is reset, powered up, or the IP address is granted by network changes.
Use Alternate DNS 2 - Set another DNS User.
Note: You can set up a second DNS User, if you have two DNS users.
*DNS1 and *DNS2 - The primary and secondary DNS servers set by Provider
when your RLXIC-SG gets its IP address.
*DNSUSER - Set this, if desired, to an additional DNS server to query first
before the primary or secondary (just as a hosts file is queried first on a computer). If *DNSUSER is set to 0.0.0.0, it will be ignored.
8.5.2 The "PPP-Peer" Domain Name
The RLXIC-SG uses the unqualified domain name of "ppp-peer" when it is in PPP or SLIP address mode to resolve the address of the device or computer connected via PPP or SLIP address. If the RLXIC-SG is not in PPP or SLIP address mode, "ppp-peer" will resolve to 0.0.0.0.
Page 72 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuring Modbus/BSAP RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
9 Configuring Modbus/BSAP
In This Chapter
Modbus Overview..................................................................................73
Configuring the RLXIC-SG at the Polling Host for Modbus on UDP......75
Configuring the Remote RLXIC-SGs for Modbus with UDP..................77
The RLXIC-SG supports Modbus ASCII, Modbus RTU, BSAP, and can also emulate other protocols like DF1 or others using its Modbus Variable feature.
9.1 Modbus Overview
The Modbus Protocol, developed by Modicon in 1979, provides for client-server (also referred to as master-slave) communications between intelligent devices. As a de facto standard, it is the most widely used network protocol in the industrial manufacturing environment to transfer discrete/analog I/O and register data between control devices. Modbus, BSAP, and other Modbus variations are often used in conjunction with telemetry devices.
Tip: This section is just a brief overview of Modbus. For more information, refer to your Modbus equipment distributor or manufacturer or http://www.modbus.org.
9.1.1 Telemetry
Telemetry is an automated communications process by which data is collected from instruments located at remote or inaccessible points, and transmitted to receiving equipment for measurement, monitoring, display, and recording. Trans­mission of the information may be over physical pairs of wires, telecommunication circuits, radios or satellite.
9.1.2 Remote Terminal Unit (RTU)
Modbus was originally designed to be used in a radio environment where packets are broadcast from a central station (also called master or host) to a group of remote units. Each remote unit, Remote Terminal Unit (RTU), has a hexadecimal identification number (ID). The first part of the broadcast packet contains an RTU ID which corresponds to the ID of one of the remote units. The Modbus host looks for the ID, and sends to only the unit with the matching ID. The RTU would then reply back to the central station.
The RTU connects to physical equipment such as switches, pumps, and other devices, and monitors and controls these devices. The RTU can be part of a network set up for Supervisory Control and Data Acquisition.
ProSoft Technology, Inc. Page 73 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring Modbus/BSAP RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
9.1.3 Supervisory Control and Data Acquisition (SCADA)
Supervisory Control and Data Acquisition (SCADA) describes solutions across a large variety of industries, and is used in industrial and engineering applications to monitor and control distributed systems from a master location. SCADA encompasses multiple RTUs, a central control room with a host computer (or network), and some sort of communication infrastructure.
SCADA allows for "supervisory" control of remote devices as well as acquiring data from the remote locations. Programmable Logic Controllers allow for a higher degree of automated SCADA.
9.1.4 Programmable Logic Controller (PLC)
A Programmable Logic Controller (PLC) is a small industrial computer which generally monitors several connected sensor inputs, and controls attached devices (motor starters, solenoids, pilot lights/displays, speed drives, valves, etc.) according to a user-created program stored in its memory. Containing inputs and outputs similar to an RTU, PLCs are frequently used for typical relay control, sophisticated motion control, process control, Distributed Control System, and complex networking.
9.1.5 Modbus TCP/IP
Modbus TCP/IP simply takes the Modbus instruction set and wraps TCP/IP around it. Because TCP/IP is the communications standard for the Internet and most networked computers, this provides a simpler installation. Modbus TCP/IP uses standard Ethernet equipment.
9.1.6 RLXIC Modbus on UDP
When RadioLinx modems are used in place of radios, one RLXIC-SG is connected to the central station (host) and the other RLXIC-SG is connected to each remote unit. When the RLXIC-SG is configured for Modbus with UDP, the RLXIC-SG connected to the host can store a list of IP addresses or names with matching IDs. When the host at the central station sends serial data as a poll request, the RLXIC-SG at the host matches the RTU ID to a corresponding IP of a RLXIC-SG at a remote unit. A UDP packet is assembled encapsulating the RTU ID and serial data transmitted from the host. The UDP packet is then transmitted to the specific RLXIC-SG at the remote unit matching the RTU ID. The remote RLXIC-SG then disassembles the packet before transmitting the RTU ID and serial data to the remote unit. The remote units operate in normal UDP mode, and their data is sent to the host via the remote RLXIC-SG and host RLXIC-SG.
Page 74 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuring Modbus/BSAP RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
9.2 Configuring the RLXIC-SG at the Polling Host for Modbus on UDP
This section covers a Polling Host with standard Modbus, variations may need additional AT commands.
9.2.1 Configure the listening/device ports
In AceManager, select MISC in the side menu.
The destination port for the modem at the host needs to match the device port (*DPORT) in use on all the modems at the remote sites. For example, if the remote modem's device port (*DPORT) is "12345", then the Modbus host modem's S53 destination port should be set to "12345".
Take note of (or set) the Device Port setting in *DPORT to configure the destination port on the remote modems.
9.2.2 Configure the default mode for start-up.
In AceManager, select UDP in the side menu. Select the appropriate MD mode from the drop down menu.
ProSoft Technology, Inc. Page 75 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring Modbus/BSAP RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
MD13: Modbus ASCII  MD23 : Modbus RTU (Binary)  MD33: BSAP  MD63: Variable Modbus - individual parameters are set up manually.
9.2.3 Configure IP addresses for the Modbus IDs.
The last step of configuring the modem at the host is setting the IDs to their specific IPs. In AceManager, select the menu option A
DDR LIST.
Addresses can be entered in decimal or hex. AceManager will translate hex entries into decimal. The number before the "=" is ID, the number after is the IP address. There can be a total of 100 remote ID/Local addresses entered into the modem.
When using AT commands via telnet or direct serial connection, use ATMLIST for decimal IDs, and ATMLISTX for hexadecimal. For example, if the ID is 27, and the IP is 123.123.123.124, you would enter it as ATMLIST27=123.123.123.124 or ATMLISTX1B=123.123.123.124.
9.2.4 Optional: Dynamic IP Address
If you do not have a static IP, the host modem should be configured to report its current IP to a Dynamic DNS (DDNS) server with IP Manager.
In the Host modem's configuration, instead of IP address for the Addr List (ATMLIST or ATMLISTX), substitute a single unique name for each modem, that is, remote1, remote2, etc.
When you configure IP Manager for the host modem, make note of your modem name and domain setting in AceManager in the menu selection D used with the remote modems.
YNAMIC IP to be
Page 76 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuring Modbus/BSAP RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
With names instead of IP addresses for the Address List, the host modem will query the DNS server for the current IP address assigned to the specific name of a remote modem to send a message corresponding to the ID.
When you use names instead of IP addresses, to ensure your modems are updated quickly with the correct IP addresses for the names, you will want to set the DNS settings as well. In AceManager, select DNS.
Configure *DNSUSER to the same IP address as the IP Manager (*IPMANAGER1). If your modems have dynamic IP addresses, and not static (the IP address can change when it is powered up), configure *DNSUPDATE to a low interval to allow frequent updates.
9.3 Configuring the Remote RLXIC-SGs for Modbus with UDP
This section covers standard Modbus settings for the RLXIC-SG at the remote unit, variations may need additional commands.
9.3.1 Configure the ports
In AceManager, select MISC in the side menu.
ProSoft Technology, Inc. Page 77 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring Modbus/BSAP RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
The destination port for the modem at the host needs to match the device port in use on all the modems at the remote sites. For example, if the remote modem's device port (see below) is "12345", then the Modbus host modem's S53 destination port should be set to "12345".
Set the destination port (S53) to match the device port of the host modem (*DPORT). Make sure the device port of the remote modem (*DPORT) matches the destination port of the host modem (S53).
9.3.2 Configure IP addresses for the host.
If the Host modem has a static IP address, enter it in the Destination Address for S53.
Note: With a name instead of IPs for the host modem, the remote modems will query the DNS server for the current IP assigned to the host modem before sending data back to the host.
If the modem at the host has a dynamic IP, and is using IP Manager, instead of an IP address for S53, specify the name of the host modem (*MODEMNAME). If the remote modems are using a different DDNS than the host modem, you will need to specify the fully qualified domain name (*MODEMNAME+*DOMAIN).
Note: Setting the Host modem IP address as the S53 Destination Address provides a low level security. The modem will not forward UDP traffic unless the source IP/port matches what is in S53. However, if you set *AIP=1, the modem will forward UDP traffic from any source IP address as long as it is accessing the modem on the configured *DPORT.
9.3.3 Configure the default mode for start-up.
Each modem at the remote locations will need to be configured to communicate with the modem at the host. In AceManager, select UDP in the side menu.
1 Enable S82, UDP auto answer. 2 Set S83 to the idle time-out applicable to your application, commonly 20.
Page 78 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuring Modbus/BSAP RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
9.3.4 Configure other RTU settings.
Other parameters may need to be changed, but this is dependent on the RTU type being used. As a minimum, this typically involves setting the proper serial settings to match your RTU.
9.3.5 Optional: Dynamic IP Address
If you do not have a static IP, the host modem should be configured to report its current IP to a Dynamic DNS (DDNS) server with IP Manager.
You will need to match the name of the modem to the names specified in the host modem's MLIST or MLISTX for the connected RTU.
When you configure IP Manager for the host modem, make note of your modem name and domain setting in AceManager in the menu selection D used with the remote modems.
YNAMIC IP to be
When you use names instead of IP addresses, to ensure your modems are updated quickly with the correct IP addresses for the names, you will want to set the DNS settings as well. In AceManager, select DNS.
Configure *DNSUSER to the same IP address as the IP Manager (*IPMANAGER1). If your modems have dynamic IP addresses, and not static (the IP address can change when it is powered up), configure *DNSUPDATE to a low interval to allow frequent updates.
ProSoft Technology, Inc. Page 79 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuring Modbus/BSAP RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Page 80 of 136 ProSoft Technology, Inc.
May 29, 2009
SNMP : Simple Network Management Protocol RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
10 SNMP : Simple Network Management Protocol
In This Chapter
SNMP Configuration..............................................................................82
SNMP MIB Definition Sample................................................................84
The Simple Network Management Protocol (SNMP) was designed to allow remote management and monitoring of a variety of devices from a central location. The SNMP management system is generally composed of agents (such as your RLXIC-SG, a router, a UPS, a web server, a file server, or other computer equipment), and a Network Management Station (NMS) which monitors all the agents on a specific network. Using the management information base (MIB), an NMS can include reporting, network topology mapping, tools to allow traffic monitoring and trend analysis, and device monitoring.
Authentication ensures SNMP messages coming from the agent, such as the RLXIC-SG, have not been modified, and the agent may not be queried by unauthorized users. SNMPv3 uses a User-Based Security Model (USM) to authenticate, and, if desired or supported, message encryption. USM uses a user name and password specific to each device.
The RLXIC-SG can be configured as an SNMP agent, and supports SNMPv2c and SNMPv3.
10.1.1 Management Information Base (MIB)
The management information base (MIB) is a type of database used to compile the information from the various SNMP agents. Reports from various agents, such as the RLXIC-SG, are sent as data in form designed to be parsed by the NMS into its MIB. The data is hierarchical with entries addressed through object identifiers.
10.1.2 SNMP Traps
SNMP traps are alerts that can be sent from the managed device to the Network Management Station when an event happens. Your RLXIC-SG is capable of sending the linkUp trap when the network connection becomes available.
ProSoft Technology, Inc. Page 81 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular SNMP : Simple Network Management Protocol RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
10.2 SNMP Configuration
To configure your RLXIC-SG to work as an SNMP agent, you can use either AceManager, or a terminal connection to configure the modem using AT commands. In AceManager, the SNMP commands are all part of the Other group under the Common group.
There are only three commands to set for SNMP in the RLXIC-SG: the listening port, the security level, and the trap destination.
10.2.1 Listening Port
*SNMPPORT sets the port for the SNMP agent to listen on. If set to zero, default, SNMP is disabled.
Tip: SNMP generally uses port 161, however most Internet providers (including cellular) block all ports below 1024 as a security measure. You should be able to use a higher numbered port such as 10161.
10.2.2 Security Level
*SNMPSECLVL sets the security level and which version of SNMP communications are used.
0 - No security required. SNMPv2c and SMNPv3 communications are
allowed.
1 - Authentication required. SNMPv3 is required to do authentication, and
SNMPv2c transmissions will be silently discarded. Authentication is equivalent to the authNoPriv setting in SNMPv3.
2 - Authentication required, and messages are encrypted. SNMPv3 is
required to do authentication. SNMPv2c, and SNMPv3 authNoPriv transmissions will be silently discarded. Authentication and encryption is equivalent to the authPriv setting in SNMPv3.
Page 82 of 136 ProSoft Technology, Inc.
May 29, 2009
SNMP : Simple Network Management Protocol RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
10.2.3 User Name and Password
The user name is "user". The user name cannot be changed. The RLXIC-SG's password is used as the SNMP password (default is "12345").
To change the password in the RLXIC-SG, select Modem from the top menu line in AceManager.
The current password will be pre-entered. As you type the new password and confirm it, the characters you type will be obscured by "x". For the password, you can use numbers, letters, and/or punctuation.
Caution: The password is case sensitive. "drowssaP" is not the same as "drowssap".
10.2.4 Trap Destination
*SNMPTRAPDEST needs to be set with the destination IP and port. If either are set to zero or empty, SNMP traps are disabled.
Note: Traps are sent out according to the SNMP security level (that is, if the security level is 2, traps will be authenticated and encrypted). Currently, the only trap supported is LinkUp.
10.2.5 Community String
The community string can be configured using *SNMPCOMMUNITY. The default is "public".
ProSoft Technology, Inc. Page 83 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular SNMP : Simple Network Management Protocol RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
10.3 SNMP MIB Definition Sample
AIRLINK-MIB DEFINITIONS ::= BEGIN IMPORTS ObjectName FROM SNMPv2-SMI MODULE-COMPLIANCE FROM SNMPv2-CONF; org OBJECT IDENTIFIER ::= { iso 3 } dod OBJECT IDENTIFIER ::= { org 6 } internet OBJECT IDENTIFIER ::= { dod 1 } private OBJECT IDENTIFIER ::= { internet 4 } enterprises OBJECT IDENTIFIER ::= { private 1 } airlink OBJECT IDENTIFIER ::= { enterprises 20542 } general OBJECT IDENTIFIER ::= { radiolinx 1 } common OBJECT IDENTIFIER ::= { radiolinx 2 } status OBJECT IDENTIFIER ::= { radiolinx 3 } gps OBJECT IDENTIFIER ::= { radiolinx 4 }
-- GENERAL -­phoneNumber OBJECT-TYPE SYNTAX DisplayString (SIZE (10)) MAX-ACCESS read-only STATUS current ::= { general 1 } deviceID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 2 } electronicID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 3 } modemType OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 4 } aleosSWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 5 } aleosHWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 6 } modemSWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 7 } modemHWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current
Page 84 of 136 ProSoft Technology, Inc.
May 29, 2009
SNMP : Simple Network Management Protocol RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
::= { general 8 }
-- COMMON -­date OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 1 } otaProgrammingEnable OBJECT-TYPE SYNTAX INTEGER { disabled(0), enabled(1) } MAX-ACCESS read-only STATUS current ::= { common 2 } devicePort OBJECT-TYPE SYNTAX INTEGER(0..65535) MAX-ACCESS read-only STATUS current ::= { common 3 } netUID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 4 } netPW OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 5 } requestPAP OBJECT-TYPE SYNTAX INTEGER { no(0), yes(1) } MAX-ACCESS read-only STATUS current ::= { common 6 } destinationAddress OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 7 } destinationPort OBJECT-TYPE SYNTAX INTEGER(0..65535) MAX-ACCESS read-only STATUS current ::= { common 8 } serialPortSettings OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 9 } serialPortFlowControl OBJECT-TYPE SYNTAX INTEGER { none(0), hardware(2), software(4) }
ProSoft Technology, Inc. Page 85 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular SNMP : Simple Network Management Protocol RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
MAX-ACCESS read-only STATUS current ::= { common 10 }
-- STATUS -­ipAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current ::= { status 1 } netState OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 2 } netChannel OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 3 } rssi OBJECT-TYPE SYNTAX INTEGER(-125..-50) MAX-ACCESS read-only STATUS current ::= { status 4 } serialSent OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 5 } serialReceived OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 6 } hostMode OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 7 } powerMode OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 8 }
fixObtained OBJECT-TYPE SYNTAX INTEGER { no(0), yes(1) } MAX-ACCESS read-only STATUS current ::= { gps 1 }
satelliteCount OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only
Page 86 of 136 ProSoft Technology, Inc.
May 29, 2009
SNMP : Simple Network Management Protocol RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
STATUS current ::= { gps 2 } latitude OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { gps 3 } longitude OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { gps 4 } END
10.3.1 Display Responses
The string that is displayed for these objects is the same display for the corresponding AT Command.
Object AT Command
phoneNumber *NETPHONE? deviceID *DEVICEID? electronicID I3 aleosSWVer I1 aleosHWVer I1 modemSWVer I2 modemHWVer I2 date *DATE? otaProgrammingEnable OPRG? devicePort *DPORT? netUID *NETUID? netPW *NETPW? requestPAP *HOSTPAP? destinationAddress S53 destinationPort S53 serialPortSettings S23 serialPortFlowControl \Q ipAddress *NETIP? netState *NETSTATE? netChannel *NETCHAN? rssi *NETRSSI? hostMode *HOSTMODE?
10.3.2 Product ID
Each modem type has a unique ID associated with it so you can more easily identify the modem from its type on your network.
ProSoft Technology, Inc. Page 87 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular SNMP : Simple Network Management Protocol RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Page 88 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuration Commands RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
11 Configuration Commands
In This Chapter
Info (information)...................................................................................89
Status....................................................................................................91
Common................................................................................................93
Logging................................................................................................120
Telemetry/Addr List.............................................................................121
Edge/HSDPA.......................................................................................123
The configuration commands (AT commands) in this chapter are arranged according to their placement in AceManager.
Note: Some commands can only be configured using a terminal emulation and typed AT commands. Some commands also require PassThru mode. Tip: You can use a fully qualified domain name instead of an IP address for most configuration options calling for an IP address if your RLXIC-SG is configured to use DNS. DNS settings frequently come directly from your cellular provider while your RLXIC-SG is registering on the cellular network, and receiving its IP address.
11.1 Info (information)
The commands in the "Info" group have read-only parameters. They only provide information about the modem. Some of the information displayed in this group does not correspond directly to AT commands.
*DEVICEID?
The 64-bit device ID the modem uses to identify itself to the cellular network.
ProSoft Technology, Inc. Page 89 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuration Commands RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
*NETPHONE?
The modem's phone number, if applicable or obtainable.
&V View active profile, the contents of the active registers. Not displayed with
AceManager.
In
n=0 : Product name (for example, RLXIC-SG).  n=1 : The RLXIC-SG's firmware (ALEOS) version, hardware ID, and
copyright.
n=2 : The internal hardware's firmware version, and relevant hardware ID.  n=3 : The hardware module's unique identification number or serial number.  n=5 : View active profile (the contents of the active registers). Not displayed
with AceManager.
11.1.1 Information Displayed in AceManager without AT Commands Listed
Versions of ALEOS, internal hardware, boot, and MSCI: Versions of
internally configured hardware and software.
Page 90 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuration Commands RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
11.2 Status
Most of the commands in the "Status" group have read-only parameters, and provide information about the modem. The Status Group has more fields that can be displayed on most screens. You can either resize your window or use the scroll bar on the side to display the remainder.
*BOARDTEMP?
The temperature, in Celsius, of the internal hardware.
*HOSTMODE?
The current host mode (AT, PPP, UDP, etc.). If the RLXIC-SG is not in AT mode, telnet into the modem to execute this command.
*NETIP?
Note: If there is no current network IP address, 0.0.0.0 may be displayed.
The current IP address of the modem reported by the internal module, generally obtained from your cellular provider. This is the address can contact the RLXIC­SG from the Internet.
Tip: Use *NETALLOWZEROIP if you need to allow the display of an IP ending in a zero.
ProSoft Technology, Inc. Page 91 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuration Commands RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
*NETOP?
The current cellular carrier from the modem's firmware version, for example, your cellular provider.
*NETRSSI?
The current RSSI (Receive Signal Strength Indicator) of the RLXIC-SG as a negative dBm value.
Tip: The same information is displayed with the command S202?.
*NETSERV?
The type of service being used by the modem, for example Tech.
*NETSTATE?
The current network state: Connecting To Network: The RLXIC-SG is in the process of trying to
connect to the cellular network.
Network Authentication Fail: Authentication to the cellular network has
failed. Verify settings to activate the RLXIC-SG.
Data Connection Failed: The RLXIC-SG failed to connect, and it is now
waiting a set time interval before it attempts to reconnect. Verify settings to activate the RLXIC-SG.
Network Negotiation Fail: Network connection negotiation failed. This is
usually temporary, and often clears up during a subsequent attempt.
Network Ready: The RLXIC-SG is connected to the 1x cellular network, and
ready to send data.
Network Dormant: The RLXIC-SGis connected to the 1x cellular network,
but the link is dormant. It will be woken up when data is sent or received.
No Service: There is no cellular network detected.  Hardware Reset: The internal module is being reset. This is a temporary
state.
*POWERIN?
The voltage input to the internal hardware.
11.2.1 Information Displayed in AceManager without AT Commands Listed
Bytes and Packets Received and Sent: Network traffic for the applicable
port.
Number of System Resets: Counter of the number of system resets over
the life of the modem or since the configuration was reset.
Bad Password Count: Counter of the number of bad password attempts.  IP Reject Count or Log: Rejected IP Data.  Temperature of the Internal Hardware Module: The temperature of the
internal radio module.
Page 92 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuration Commands RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
11.2.2 AT Commands Requiring PassThru mode
These commands are not displayed in AceManager.
11.3 Common
The groups under the heading Common encompass those commands that are common to most RadioLinx modems.
11.3.1 Misc (Miscellaneous)
The commands of the "Misc" group are a variety of commands that do not directly fit in other categories.
Enable Event Reporting = n
Enable or disable Event Reporting, by selecting either 1-Turn on ER or 0-Turn off ER. If you choose to enable, click on Write, and then Refresh all to see all the ER fields.
n=0 : Disables  n=1 : Enables
+++
Note: +++ is not proceeded by AT nor does it require a carriage return (enter). There must be an idle time (set by S50) on the serial port before and after this command.
AT Escape sequence. If the RLXIC-SG is in a data mode (any mode other than PassThru), this command causes the modem to re-enter AT command mode. The "+" is ASCII 0x2B.+++ is not available in AceManager.
ProSoft Technology, Inc. Page 93 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuration Commands RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Tip: DAE=1 disables the +++ command.
A/
Note: A/ is not proceeded by AT.
Re-execute last command. A/ is not used in AceManager.
A Manually answer an incoming connection. A is not used in AceManager.
D[method][d.d.d.d][/ppppp] or D[method][@name][/ppppp]
Dial a connection to a remote IP and Port using method. Cannot be configured in AceManager.
method=P : Establish a UDP connection  method=T : Establish a TCP connection  method=N : Establish a Telnet connection  d.d.d.d= IP address to contact ppppp= port to contact
Examples:
ATD - Dial (establish) default connection. ATDP192.168.13.31/2332 - Dial (establish) UDP session to 192.168.13.31, at
port 2332.
To end the connection, issue the +++ escape sequence or drop the DTR line (if Ignore DTR S211=0 or &D2). The default connection is set in S53.
If the method, IP address, or port is omitted, the values from S53 are used. If a telnet connection is requested (N), and the port is not supplied, port 23 will be used instead of the value from S53.
If a domain name is specified, the "@" symbol can be used to explicitly indicate the start of the name. For example, if ATDPHONY is issued, this will be interpreted as dial a UDP connection to "HONY". To dial using the default method to host "PHONY", one would issue ATD@PHONY.
Several special dialing numbers exist to make it easy to establish a PPP or SLIP connection with the modem. ATD#19788 or ATDT#19788 will establish a PPP connection (see \APPP) and ATDT#7547 will establish a SLIP connection (see \ASLIP).
Tip: The source port of the session is the Device Port (set by S110 or *DPORT).
Page 94 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuration Commands RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
DS=n
Allows a PPP connection to be initiated on the host port. n=2 : Initiates the PPP connection.
Cannot be configured in AceManager.
Hn
Hang-Up Command. n=1 : Hang-up With an AT telnet connection, this command will terminate the host data mode,
and return the RLXIC-SG to an AT mode. Cannot be accessed in AceManager.
O
Online (Remote): Causes the RLXIC-SG to go from Command State to data state. Cannot be configured in AceManager.
OPRG=n
Enables/disables over-the-air firmware upgrading of the RLXIC-SG. When ProSoft Technology releases a new version of ALEOS, you can upgrade your remote modems with OPRG enabled.
n=0 : Disables  n=1 : Enables
S53=[method][d.d.d.d][/ppppp]
Destination IP address, port, and method. These are used as defaults for the D (Dial) AT command.
method= P : UDP  method=T : TCP  method=N : Telnet d.d.d.d=IP address or domain name  ppppp=the port address
Examples:
ATS53=T192.168.100.23/12345 ATS53=foo.earlink.com
Telnet to the specified IP at port 12345.
ATS53=192.168.100.23/12345
Query the specified IP at port 12345.
ATS53=/12345
Query port 12345.
ProSoft Technology, Inc. Page 95 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuration Commands RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Z
Reset the RLXIC-SG. In AceManager, this command is performed with the Reset option on the toolbar.
Tip: *DATZ=1 will disable Z.
&W
Writes all changed modem settings. If this command is not issued, any modified values will revert back to their previous values at modem reset. Cannot be configured in AceManager.
*DATE=[mm/dd/yyyy],[hh:mm:ss]
Sets and queries the internal clock. Either the date and time can be specified, or simply one of the two can be specified in which case the unspecified value will remain unchanged. The date and time are always specified 24-hour notation.
mm/dd/yyyy=date in month/day/year notation  hh:mm:ss=time in 24-hour notation
*DPORT=n
The modem's Device Port which the modem is listening on for inbound packets/data/polls. Can also be set with the command S110.
n=1-65535
*HOSTPAP=n
Use PAP to request the user login and password during PPP negotiation on the host connection.
n=0 : Disable PAP request (Default).  n=1 : Takes user login and password from Windows DUN connection, and
copies to *NETUID and *NETPW.
*NETALLOWZEROIP=n
Allows the displayed IP address in *NETIP to end in zero (ex. 192.168.1.0).
n=0 : Do not allow.  n=1 : Allow.
*NETPW=pw
The password that is used to login to the cellular network, when required. pw=password (30 characters maximum)
*NETPHONE?
The modem's phone number, if applicable or obtainable.
Page 96 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuration Commands RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
*NETUID=uid
The login that is used to login to the cellular network, when required. uid=user id (up to 64 bytes)
*STATICIP=d.d.d.d
Set the static IP required to be received from the network. If the modem does not get this IP address from the network, it will reset the internal hardware, and try again. The default is 0.0.0.0, which allows any IP address from the network.
d.d.d.d=IP address Example:
AT*STATICIP=192.168.1.23
Caution: STATICIP does not set the IP address of the modem, it merely tells the modem which IP address to expect. If the expected IP address is not granted while registering on the cellular network, the modem will try to register on the network again until it receives that IP address. If your account is set up for a dynamic IP address, and you set an address for *STATICIP, you may not be able to register on the network at all because there is no guarantee you will receive the same dynamic IP address again.
*STATUSCHK=n
Checks if an SMS message has been received by the modem.
n=1-255 : Seconds between checks. n=0 : Never check.
11.3.2 Serial
This group includes commands specific to general use of the serial port.
ProSoft Technology, Inc. Page 97 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuration Commands RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
En
Toggle AT command echo mode.
n=0 : Echo Off.  n=1 : Echo On.
Note: With more than one connection types (serial, and Telnet, and USB) the echo command can be set differently on each interface. USB is only available on RLXIC Serial radios.
Qn
The AT quiet-mode setting. If quiet mode is set, there will be no responses to AT commands except for data queried.
n=0 : Off (Default). n=1 : Quiet-mode on.
S3=n
The standard end of line character used to indicate the end of an AT command. This character is also used as the carriage return character for framing responses and result codes in command state. Cannot be configured in AceManager.
S4=n
The standard line feed character sent by the modem to the host at the end of a response or return code in command state. Cannot be configured in AceManager.
S5=n
This register sets the character recognized as a backspace during command entry. Cannot be configured in AceManager.
S6=n
This register denotes the wait time, in seconds, before a blind dial (no dial tone detection). Cannot be configured in AceManager.
S8=n
Whenever a dial command contains the comma character, the contents of this register specify the pause time for each comma. Cannot be configured in AceManager.
S9=n
Specifies the time that the received carrier must be present for the modem to recognize it, and turn on Data Carrier Detect (DCD) if applicable. The implementation is entirely at the IWF modem. Cannot be configured in AceManager.
Page 98 of 136 ProSoft Technology, Inc.
May 29, 2009
Configuration Commands RLXIC-SG ♦ Intelligent Cellular User Manual RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM
S10=n
Specifies the amount of time that the carrier from the remote modem can be lost before the modem goes on-hook. This allows temporary disruptions to carrier without disconnecting. A setting of 255 causes the modem to disable Carrier Detect, and presume carrier is always present. Cannot be configured in AceManager.
S23=[speed],[databits][parity][stop bits]
Serial line parameters. The settings take affect after reset. speed=300 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400 | 57600 | 115200 |
230400
databits=7 or 8 (Databits MUST be 8 data bits for PPP mode.)  parity=O : Odd  parity=E : Even  parity=N : None  parity=M : Mark  stopbits=1 | 1.5 | 2
Example:
ATS23=19200,8N1
Sets modem to 19200, 8 databits, no parity, and 1 stop bit.
Tip: Can also be set using &L=[speed],[databits] [parity][stop bits]
S50=n
Data forwarding idle time-out. If set to 0, a forwarding time-out of 10ms is used. Used in UDP or TCP PAD mode.
n=tenths of a second
S51=n
PAD data forwarding character. ASCII code of character that will cause data to be forwarded. Used in UDP or TCP PAD mode.
n=0 : No forwarding character.
S211=n
For applications or situations where hardware control of the DTR signal is not possible, the modem can be configured to ignore DTR. When Ignore DTR is enabled, the modem operates as if the DTR signal is always asserted.
n=0 : Use hardware DTR. (default).  n=1 : Ignore DTR.  n=3 : Ignore DTR, and assert DSR. This value is deprecated, and it is
recommended to use &S to control the DSR instead. When this value is set to 3, &S will automatically be set to 0. See also: &D and &S.
ProSoft Technology, Inc. Page 99 of 136 May 29, 2009
RLXIC-SG Intelligent Cellular Configuration Commands RadioLinx Intelligent Cellular Serial Modem for Global GPRS/GSM User Manual
Vn
Command Response Mode.
n=0 : Terse (numeric) command responses n=1 : Verbose command responses (Default).
Xn
Extended Call Progress Result mode.
n=0 : Turn off extended result codes (Default). n=1 : Turn on result codes. This adds the text 19200 to the CONNECT
response.
&Cn
Set DCD mode.
n=0 : Always assert DCD. n=1 : Assert DCD when in a data mode (UDP, TCP, PPP, or SLIP) (Default).  n=2 : Assert DCD when the modem has network coverage.
&Dn
Set DTR mode. n=0 : Ignore DTR, same effect as HW DTR always asserted (same as
S211=1).
n=2 : Use hardware DTR (same as S211=0).
&Sn
Set DSR mode.
n=0 : Always assert DSR (Default).  n=1 : Assert DSR when in a data mode (UDP, TCP, PPP, or SLIP) (Default).  n=2 : Assert DSR when the modem has network coverage.
Tip: S211 can also be used to request that DSR is always asserted. If S211 is set to 3, and &S is changed to a non-zero value, S211 will be changed to 1.
\APPP
Set modem operation to PPP mode. Cannot be configured in AceManager.
\ASLIP
Set modem operation to SLIP mode. DTR must be asserted (&D0 or S211=1). Cannot be configured in AceManager.
Page 100 of 136 ProSoft Technology, Inc.
May 29, 2009
Loading...