INTRODUCTION Sutron’s Xpert family of DCPs (both the 9210/B and the Xpert/2) have been designed to be easily expandable by adding additional software libraries, called Sutron Link Libraries (SLLs). One such library is Iridium.sll, which adds the ability for the Xpert to communicate over the Iridium network using Short Burst Data (SBD) messages.
INSTALLATION This section describes installation of the Iridium.sll library. Installation To install the Iridium.sll library, copy the file to the “\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.
FEATURES This section discusses what features are supported related to Iridium communications. • Self-timed (scheduled) Mobile Originated (MO) telemetry data using Short Burst Data (SBD) • Alarm MO telemetry data using SBD • Scheduled and manually initiated processing of incoming command messages, i.e., Mobile Terminated (MT) messages •...
CONFIGURATION This section discusses how to configure the Xpert to process Iridium messages. There are three different places you’ll go to use and configure the Xpert for Iridium communications: • Iridium Entry - Setup Tab • ISBD Blocks - Graphical Setup and EzSetup •...
Figure 2: Iridium Properties Dialog Enabled The Enabled checkbox determines whether Xpert will do any kind of Iridium processing. The checkbox must be checked for Xpert to initiate self-timed and alarm transmissions, process incoming commands over Iridium, etc. If Enabled is not checked, the Xpert behaves as if the modem is not connected, and will not process any incoming or outgoing transmissions.
Again, the irsenxt and irse commands must be received via Iridium short burst data (SBD) message to take effect. These commands won’t work if issued over the Xpert command line. Iridium Transmit Settings To configure self-timed (scheduled) Mobile Originated (MO) transmissions, select the “Transmit”...
Page 10
12:15AM, 4:15AM, 8:15AM, 12:15PM, 4:15PM, … 04:00:00 00:15:00 Retransmit When checked, data from failed self-timed transmissions (due to temporary lack of satellite in view, for example), are retransmitted on the next successful self-timed connection. Note that the most recent data is always transmitted first on the first successful reconnect, followed by the oldest to newest data from failed transmissions.
Page 11
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.
Transmit “Content” Dialog When you press the Content button on the Iridium Transmission Settings dialog, the “Set Tx Content” dialog opens showing a list of all ISBD blocks in the graphical setup (as well as any data points tagged in EzSetup). Figure 4: Select Tx Content When more entries exist than can be shown in the dialog, scroll bars appear, allowing you to scroll to other entries.
!info Show the current system status !irsenxt MM/DD/YYYY HH:MM:SS Set next Iridium epoch date !irse MM/DD/YYYY HH:MM:SS Set the current Iridium epoch date !irsmdb nnn Set Max Data Bytes to nnn (replace nnn with number) Return sensor and tag listing, “pword” required for pword !show authorization Reboot the station, “pword”...
Powered-on “Listen” Periods During these periods, the modem is powered and will process an incoming message if and when it is received. You are charged for the cost to retrieve the message. The advantage of this method over Scheduled Message Checks is that you won’t be charged for message checks when no message is waiting.
Figure 6: Example ISBD block setup In the setup depicted above, ISBD blocks “tag” two measured data points, that of, Air Temp and Barom. Here are some important notes about the setup: • The ISBD block appears after Alarm block. This ensures the ISBD blocks “sees” the result of the alarm evaluation, triggering alarm transmissions, if needed.
The ISBD Edit Tag dialog is used to edit the properties of the ISBD block that “tags” the data point for transmission. Note, if the selected format is “BUFR”, the settings differ slightly than what is shown and described here. Please see BUFR, later in this document, for details. Label Label defines the “name”...
Public Function SELFTIMED_STFormatter Selftimed_STFormatter = "Test Selftimed Message" End Function 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.
TESTING IRIDIUM OPERATIONS This section discusses testing your Iridium setup to verify communications and other functions are correct. Iridium Diagnostics Tab The Iridium tab contains diagnostic information and tools you can use to verify everything works as desired. Figure 9: Iridium Diagnostics Tab Modem Status Modem status describes the current state of Iridium processing, and may be any one of the values in the following table:...
Comm Error! An error has occurred talking to modem (check connection to modem) Starting System is starting up Stopping System is stopping Stopped Iridium processing has stopped (no transmissions or message checks will occur) Next Task Status Next task describes the task next scheduled for processing. Next task time describes when this task will occur.
Figure 11: Today's Self-timed Statistics Dialog Alarm Statistics Press the “Alarm statistics” button on the Iridium tab to bring up the following dialog showing detailed information about the current day’s alarm transmissions. Figure 12: Today's Alarm Statistics Dialog Total Data Statistics Press the “Total data statistics”...
Figure 13: Today's Totals Dialog Total Tx/Rx Errors Total tx/rx errors increments any time the system has a problem transmitting or receiving due to a weak signal. Hence, you can use this figure to evaluate how well your antenna is placed. Note that a tx/rx error does NOT mean a transmission totally failed (was never transmitted), but only that an error occurred while trying to transmit.
Total errors occurring during either a transmit or message check attempt Test Transmission Press the “Test transmission” button on the Iridium tab to bring up a dialog prompting you for text to transmit. Pressing “Ok” in the dialog transmits the text. Pressing “X” in the dialog cancels the test transmission.
Page 23
6. Use the Iridium diagnostic tab to send test messages. 7. Contact Sutron Customer Service at 703-406-2800.
APPENDIX A – TELEMETRY FORMATS This appendix contains descriptions for each of the telemetry formats supported by Xpert Iridium. ASCII Column Format The ASCII Column format is an ASCII, human readable format placing sensor values in columns, with each row containing data from earlier measurement intervals (newest data appears in top row).
Page 25
10-Min Avg Wind Spd 10-Min Avg Wind Dir Air Temperature Fuel Temperature 10-Min Avg Rel Hum. Battery Voltage Barometric Pressure Peak Wind Direction Peak Wind Speed 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.
and “3” indicating a forced transmission. Delta Time Age in minutes of the most recent data Data 3x num Data in either interleaved, or non-interleaved sensors format. The example above shows the data interleaved (most recent of all sensors followed by next oldest, and so on).
tells the measurement interval in minutes, or the amount of time between readings of this measurement. Measurement 3 for each Sensor data encoded 6 bit binary. Data sensor reading Additional Variable If more than one measurement was setup for Measurements transmission, more data will follow.
The timestamp is similar to the one in Pseudobinary C. Pseudobinary D is smaller than Pseudobinary C and it lacks detailed timestamps that would allow one to completely reconstruct the time the data was collected from the message itself. To correctly use Pseudobinary D, the decoder needs to know the measurement setup used.
• A 3 byte encoded number can range from -131072 to +131071 Binary encoded numbers are always sent most significant bytes first. The number itself is broken down into 6-bit digits, and each digit is placed in one byte of data. The number 64 (ASCII "@") is added to each digit to make it fall within the range of displayable ASCII characters.
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.
In the above example "H+R+" indicates that STAGE is experiencing a high limit and high rate of change alarm, while the “OK” status for RAIN indicates that it is within expected limits. Quality codes: G: Good quality B: Bad quality U: Undefined quality Alarm codes: H: High limit exceeded...
Page 33
Descriptor (F X Y) The F X Y descriptor that uniquely identifies the data from Table B, e.g., 0 12 004 for “Air Temp at 2m” Units The units of the transmitted data Scale The scale applied to the data prior to transmission.
Page 34
Individual Individual values are selected based on timestamp Data Interval The time interval between readings. For example, “01:00:00” means “hourly data” Data Time The time, or offset into the interval, of the data to include. For example, “00:15:00” means “include data measured on a 15 minute offset”...
BUFR Content Options When the selected format is “BUFR”, the telemetry device settings (e.g., Satlink, LANTx, GPRS, or Iridium), offer the following BUFR content option settings for edit (accessed by pressing the “BUFR” button on the telemetry device settings dialog): Originating Center Select the originating to use in the BUFR message.
APPENDIX B – IRIDIUM TRANSMISSION HEADER This appendix describes the content and format of the header included in all Iridium transmissions (so long as “Include Header” is selected in the setup). The Facts Iridium modem buffers are limited in size, forcing software to limit the length of messages it can send at any one given time.
Page 37
Packet Structure: packet-type sub-header data Sub-header 0, two options: standard: ,id,start-byte,total-bytes: with station name: ,id,start-byte,total-bytes,station-name: Sub-header 1 thru N: ,id,start-byte: where, packet Numeric ASCII character defining packet type. See type definitions in table, -type below Numeric ASCII text defining the message id. Starts at 0. Rolls over after 99. total- Numeric ASCII text defining the total number of data bytes to be sent (data bytes...
Page 38
Hex Value ASCII Description 0x33 Entering alarm extended 0x34 Exiting alarm 0x35 Exiting alarm extended 0x36 Command response 0x37 Command response extended 0x38 Forced transmission 0x39 Forced transmission extended Reserved for future use 0x7D User defined 0x7E Look to next byte for meaning 0xFF Binary data, reserved for future use...
Need help?
Do you have a question about the XPERT Series and is the answer not in the manual?
Questions and answers