Table of Contents Introduction ......................... 5 NEW FEATURES ......................6 InstallATION ........................7 Installation........................7 Before getting started ...................... 8 Features ..........................9 Configuration ........................10 GPRS Properties ......................10 Enabled ........................11 Port ..........................11 ModemAPN ......................11 ModemUserName and ModemPassword ..............11 ModemPIN ........................
Page 3
Tagging Data with EzSetup ..................25 Basic Entry – Setup Tab ....................26 Testing GPRS Operations ....................28 The GPRS Diagnostics Tab ..................28 Modem status ......................28 Tests… ........................30 Next task ........................30 Next task time ......................30 Time ..........................
INTRODUCTION Sutron’s Xpert family of DCPs (both the 9210 and the Xpert, hereafter referred to as the Xpert) have been designed to be easily expandable by adding additional software libraries, called Sutron Link Libraries (SLLs). One such library is GPRS.sll, which adds the ability for the Xpert to communicate using a Sutron GPRS modem connected to a serial port.
“\Flash Disk” subdirectory of your Xpert using Xterm. For more information on performing this file transfer, please refer to chapter 6 of the Xpert or 9210 user manual. Once the files have been transferred, reboot the Xpert. The libraries will load automatically after the Xpert reboots.
Before getting started Typically the purpose of using the GPRS SLL is to provide internet services to an RTU and hence the LAN is not available and not used, but during initial testing setup it’s very convenient to take advantage of it. The problem is that if the internal LAN is turned on then GPRS messages will be sent using the LAN and not the GPRS device.
FEATURES This section discusses what features are supported related to GPRS communications. Self-timed (scheduled) telemetry of data using TCP/IP messaging and/or SMS text messages Alarm telemetry of data using TCP/IP or SMS Support for standard Xpert network services when used with a VPN or static IP such as Telnet, Web Server, XTerm.
CONFIGURATION This section discusses how to configure the Xpert to operate with the GPRS modem. There are three different places you’ll go to use and configure the Xpert for GPRS communications: GPRS Properties - Setup Tab GPRS Blocks - Graphical Setup and EzSetup ...
ModemUserName and ModemPassword These are used to login to the cell service provider. For some providers they can be blank, but otherwise use the value assigned by the provider or by Sutron. ModemPIN The SIM PIN unlock code. This must be specified if the SIM being used is locked. The GPRS Diagnostics Tab will warn if a SIM PIN is needed and hasn’t been entered.
Radio Band The Sutron GPRS modem supports multiple bands. Typically in the US the “Quad Mode” can be used, but internationally you may need to select the specific band to prevent frequency hopping and/or roaming. Normally, when a modem is connected to the Xpert for the first time, it is factory reset and programmed to work with pre-configured settings.
Also the GPRS modem generally needs to be reset to maintain health, which why even if the PwrOnTime, PwrOnInterval, and PwrOnDuration specify essentially a never-ending By powering on the GPRS modem the user is given the ability to communicate with the Xpert over a TELNET, TCP/IP, SSP/CL, and SMS session via the master station.
When using other modems it may be desirable to control power via a relay. When a connection is made, DTR is always asserted to the device. For non-Sutron modems which can enter standby mode when DTR is low this may be sufficient, but power to the device may be controlled by a digital switch or relay.
Figure 6: GPRS Connection Settings Dialog PrimaryIP and SecondaryIP Static IP’s and VPN access are not always available, which means it will not always be possible for a server to establish a connection with the Xpert. To deal with this, the Xpert can be configured to initiate contact with a server and send messages or wait for commands.
ServerPassword If not blank the GPRS Modem will use this password when accessing the server. This is used for authentication purposes. CSDShoulderTap When enabled, CSDShoulderTap allows the user to call the modem using the phone number given to the GPRS SIM card. The modem then will connect to what’s set to “Command Port”...
NFRDS ASCII human readable format based on NFRDS requirements Handar ASCII human readable format Sutron Standard Protocol, binary format Text ASCII human readable text format, with alarm flags Appendix A – Telemetry Formats, for detailed definitions of each of the formats.
AlarmData AlarmData can be either “SensorsInAlarm” or “AllSensors”. When set to the latter, alarm transmissions contain the same data as is found in self-timed transmissions, i.e., all data tagged with an GPRS block in the Graphical Setup (as well any data ponts tagged in EzSetup).
Figure 9: SMS Settings TxMode TxMode allows the user to receive self-timed transmissions using SMS communication. An example of this is when wanting to receive self-timed transmissions through your phone. When TxMode is set to “Scheduled”, and TxList has a phone number in it the user will receive text messages with self-timed transmissions every time a self-timed transmission is supposed to occur based on TxInterval, and TxTime in GPRS Transmission settings.
Alarms When Alarms is checked and TxList has a phone number in it, the Xpert shall also send alarm messages via SMS. The SMS message is human readable, and includes the station name so the user does not need to know the station identified by the phone number. The time is also included to account for the delays in delivery.
For example if he or she wants to send the reboot command he or she needs to use the SetupPassword string, as well send the SMS message with command from the phone number listed in SetupUserList. SMS command = Reboot SetupPassword = sutron...
An example: SetupPassword : sutron On the phone send a text message to phone number of the GPRS modem with the command “Reboot” and the authentication code like this:...
Also if the SetupUserList is enabled the user must send the command with the authorization code from that specific number listed in the SetupUserList. But be aware that if there is no SetupPassword enabled, then it doesn’t matter if SetupUserList has a phone number because the user can send the command from any phone and change the setup of the GPRS modem.
Figure 11: Alarm Block Dialog GPRS Block Properties To view and edit the properties of the GPRS block, tap the block and select “Edit Properties” in the pop-up menu that results (in EzSetup, simply press the GPRS button). The following dialog is shown: Figure 12: GPRS Edit Tag Dialog The GPRS Edit Tag dialog is used to edit the properties of the GPRS block that “tags”...
TxContent, DataInterval, DataTime, NumValues These properties define what data to include in the transmission. See the following table for details: Tx Content Description of data to transmit All the data logged for the output since the last transmission will be transmitted Individual Individual values logged for the output since the last transmission will be transmitted.
Figure 13: EzSetup Configuration Pressing the GPRS button will bring up the same GPRS Block Properties Dialog described above: Figure 14: GPRS Tag in EzSetup Basic Entry – Setup Tab A Basic program can format custom GPRS messages. Any of the Basic string functions can be used to format the buffer as required, but the Bin and Bin6 functions exist specifically to help forming 8-bit and 6-bit binary encoded data.
To create an alarm formatting routine, create a function with an “ALARM_” prefix and a single parameter in which the group number will be passed. The return value of the function becomes the buffer. For example: Public Function ALARM_Formatter(Group) ALARM_Formatter = "Test Alarm Reporting Message: " + Str(Group) End Function It's possible to append to the buffer, as opposed to simply overwriting it, by taking...
TESTING GPRS OPERATIONS This section describes how the GPRS Diagnostics Tab may be used to test out GPRS communications. The GPRS Diagnostics Tab The GPRS Diagnostics Tab may be used to test communications over GPRS, and examine the communication status. Figure 16: GPRS Diagnostics Tab Modem status Modem status describes the current state of GPRS processing, and may be any one of the...
Page 29
forward with GSM support, but will still try to establish a GPRS connection as needed GPRS Ready GPRS is registered GPRS Roaming GPRS could not establish a connection to the home network and is currently roaming on a partner network. GPRS Search GPRS is still trying to establish a connection to a tower GSM Denied...
Network Connection Status Description All Devices Connected A network link has been established Authenticated The network link has been authenticated Authentication Acknowledged A request for authentication is being acknowledged Authentication Notify Authentication is needed Authentication Retry Authentication with different credentials has been requested Connected Network connection has been established...
More… If multiple text messages have been received, pushing this button will display the last 5. Signal Quality Displays the last measured cell signal strength in terms of bars, or in dBm with % bit error rate. The dBm value can range from -51 (strong) to -113 (weak). For reference -75 is considered “5 bars”, and -105 is considered “2 bars”.
SMS Test Transmission The SMS Test Transmission screen us used to verify SMS text message operation. SMS messaging requires GSM services – which may operate in areas where GPRS service is not available. Figure 17: SMS Test Transmission The fields in the SMS Test Transmission Dialog are defined as follows: SMS Test Message Enter a message to send.
Selftimed Test Transmission The Selftimed Test Transmission screen is used to verify GPRS messaging. An ASCII message is sent to the server using the “session type 0” header. Figure 18: Selftimed Test Transmission The fields in the Selftimed Test Transmission Dialog are defined as follows: Selftimed Test Message Enter a message to send.
Figure 19: SSP Test Transmission The fields in the SSP Test Transmission Dialog are defined as follows: SSP Test Message Enter a message to send. Enter the IP address or URL of the server (or RTU) that is to receive the message. Port TCP/IP port number of the service handling SSP messages on the server.
The SMS command won’t be able to go through while the modem is powered off, but it may get through on a retry or if you happen to time it for when the station is transmitting. 11. Contact Sutron Customer Support at 703-406-2800.
APPENDIX A – TELEMETRY FORMATS This appendix contains descriptions for each of the telemetry formats supported by Xpert Iridium. Handar Format The Handar format is an ASCII, human readable format where sensors are separated by <CRLF>, sensor data is separated with a space, and missing data is reported as “M”. For example: 010034380517419:21:30G42+0NN155E9200070"...
Page 37
Fuel Moisture Solar Radiation Here’s an example NIFC telemetry report: 00.00 14.0 0486 Here’s an example NFDRS telemetry report: 00.00 14.0 0486 Note how there are no labels in the report. This is because the position of the data within the report determines the source of the data.
Pseudobinary Formats Pseudobinary formats produce ASCII reports of 6-bit pseudo-binary formatted data values. The formats are “pseudo”-binary, because each sensor value is expressed in the range of ASCII characters, but not in such a way that is readily human-readable. Pseudobinary B (Interleaved and Non-Interleaved) The Pseudobinary-B Interleaved format is identical to the 8210 binary transmission format.
Battery Logger battery voltage measured just prior to Voltage transmission Pseudobinary-C Format The Pseudobinary-C format also produces an ASCII report of 6-bit pseudo-binary formatted values, but with additional fields to describe label and time information. Just as the “B” version of the format, this format is “pseudo”-binary, because each sensor value and descriptor is expressed in the range of ASCII characters, but not in such a way that is readily human-readable.
Measurements transmission, more data will follow. Each measurement setup will have data starting with the Measurement Delimiter and ending with Measurement Data. This byte is always “.” and it is used to denote the Final Delimiter end of all measurement data. Battery This is the battery voltage measured prior to voltage...
ASCII characters. The only exception is that 127 (ASCII <DEL>) is sent as 63 (ASCII "?") Example 1. Encoding the number 10 in 1 byte: Since 10 will fit in 6-bits we only have to add 64 which would yield 74. So the number 10 would appear as ASCII 74 or the letter "J".
characters with supported characters. Please note that this requires that the characters be translated back upon reception and before they can be passed to a decoder. The following table describes the character translation that’s performed: ORIGINAL REPLACEMENT CHAR CHAR SHEF and SHEFFIX Formats “SHEF”...
SSP Format “SSP” is a binary format following the specifications of the Sutron Standard Protocol, which is useful when transmitting to XConnect or Tempest master stations. If you are interested in knowing more about the low-level details of the protocol, please contact Sutron Customer Service.
GPRS Session Protocol GPRS follows a protocol when sending self-timed and alarm transmissions that permits the server to issue commands. This protocol is often referred to as, “Session Type 0”. The protocol helps support communications to a device which has a non-routable IP address, as many IP cell modems provide.
Page 45
The server may precede each command with a "!" to signal machine mode When processing a command in machine mode, the logger: Suppresses the command echo Uses ETX (0x03) as the command prompt (i.e., follows the command response with ETX, rather than the normal command prompt) ...
Need help?
Do you have a question about the 9210 and is the answer not in the manual?
Questions and answers