ALEOS User Guide
If your AirLink device 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 device’s configured name.
Once your device’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 AirLink device will be a subdomain of the domain used by the IP Manager server.
SMS
ALEOS has the ability to:
•
Receive commands via SMS message
•
Provide information
•
Perform an action
•
Act as an SMS gateway for hosts connected to its local interfaces.
Warning:
To use SMS with your AirLink device, you will need an account with SMS enabled and your carrier cannot block SMS for data accounts.
Note: The ability to send or receive SMS requires specific security settings.
Command Parser
The ALEOS command parser SMS feature allows some remote management of the AirLink device with SMS messaging. SMS allows users to control:
•
Current status
•
Reset AirLink device
•
Control up to two relays at a device at I/O
98 4112515
Services Configuration
When an SMS command is received from a pre-defined “Trusted” phone number, the AirLink device performs the action requested and sends a response back to that same phone number.
Device Action SMS Response SMS Field
Note: All responses start with “reply from [device name]:”
status None Raven-line, pinpoint-line or MP-line
[Network IP] [Network Status]:
[technology type] RSSS [original]
PinPoint/MP adds
Lat = [Latitude]
Long = [Longitude]
Time = [hh:mm:ss]
Status
reset relay x y
Resets the device 30 seconds after the first response message is sent.
First message: Reset in 30 seconds
Second message: Status message when back up.
Sets the applicable relay to the desired setting.
relay x set to y x can be 1 or 2 y can be 0 or 1
SMS Gateway
The SMS gateway feature allows messages to or from a locally connected host to use SMS for over-the-air transmission.
Rev. 6 May.13
99
ALEOS User Guide
Figure 8-5: ACEmanager: Services > SMS > SMS Receive
100 4112515
Services Configuration
Field
SMS Destination
Description
Allows you to choose where the SMS message is going to be locally received and if it is going to be received by the ALEOS Command Parser or by a host on the other side (serial,
USB serial, or IP). Select your SMS destination; based on your selection, additional fields may become available.
Incoming messages are sent to the specified host. This can be a serial interface or an IP and port. If no host routing is configured, ALEOS treats the message as an ALEOS SMS command.
Messages sent to an IP address and port are put in the AirLink SMS Protocol in a UDP packet. ALEOS then routes this packet to the matching host interface (Ethernet, USBnet,
Wi-Fi)
If you chose:
•
Serial or USB Serial — Select “Yes” or “No” to Incoming Phone number on serial.
•
IP — Enter Destination IP and Destination port.
SMS Send Enable
•
ALEOS CMD Parser — This selection disables the SMS Gateway.
Send SMS from the connected Host. This is the device connected locally to the ALEOS device such as a computer or digital sign. When this field is enabled it will require a ALEOS port.
To send an SMS (outgoing):
•
From the serial port
From the CLI there is a new AT command to send SMS messages:
AT*SMSM2M="<phone> <message>"
This allows an SMS messages to be sent to another modem as a single line item.
•
From a Host device
PC's and other devices connected to the Host IP interfaces (Ethernet, USBNet, Wi-Fi) can also send SMS messages from the modem.
To send an outgoing SMS from the Host device, a program on the PC will need to send a message to a user-defined port in ALEOS. The message has to be in the AirLink SMS
Protocol which contains the phone number and message body (text). ALEOS will parse the message and send an SMS.
See below for examples of the SMS body text.
Rev. 6 May.13
101
ALEOS User Guide
Field
Delimiter
ACK Delimiter
UDP Message Body
Format
Non-Trusted Read
Security
Non-Trusted Write
Security
Description
Start Delimiter — Inbound message at the beginning of the message.
Separator Delimiter — Separates items in the message.
End Delimiter — Inbound message at the end of the message.
E.g., SMS to the phone number is “Left Lane Closed”.
ALEOS to Host — <<<left lane closed>>>
The packet sent to the host will have start and end delimiters which surround the message.
ALEOS will provide an ACK on every SMS message when it is passed to the radio. Wait for the ACK before sending the next SMS message. If ALEOS does not send an ACK, wait 30 seconds and retry.
The only UDP body format available is ASCII-Hex. The other types of UDP body format are set UDP protocols.
This refers to the phone numbers entered in the trusted phone number list.
Indicate with your selection — Allow Access or No Access if you want to allow or block non-trusted and trusted phone numbers to either read or write.
Default is “No Access” and trusted phone number gets read or write.
Trusted Read Security
Note: All four settings of read and write respectively are independent of each other.
Trusted Write
Security
Last Incoming Phone
Number
The last incoming phone number is displayed here and will be erased with a reboot.
SMS Password
Last Incoming
Message
Trusted Phone
Number
See
SMS Password Security on page 106.
The last incoming message is the last incoming SMS from the phone number.
Trusted phone numbers are listed here.
Add a Trusted Phone Number
Follow the instructions below to add a Trusted Phone Number on the SMS page.
1.
Send an SMS command to the device and hit Refresh. No maintenance response will be sent to a number until it is defined as Trusted.
2.
Once you have the Last incoming Phone number that shows up on the SMS screen in ACEmanager, note the exact phone number displayed.
3.
Click Add More to add a Trusted Phone Number.
Note: The Trusted Phone number can be 15 characters and has to be numbers only.
4.
Enter the Last incoming Phone number as the Trusted Phone Number.
5.
Click Apply.
102 4112515
Services Configuration
Note: Do not enter any extra digits and use the Last incoming displayed as a guide to type the phone number. Use “1” only if it is used in the beginning of the Last incoming Phone number.
SMS Wakeup
This feature applies only to the Raven XE 8795.
When the modem is in Always Off mode, this feature enables you to remotely activate a cellular IP connection. The modem later disconnects from the network
after a specified time. (See Idle period before disconnect on page 50.)
Note: Before setting up this feature, set the Always On feature (under WAN/Cellular >
Advanced) to “Disabled”.
1.
On the Services tab, select SMS Wakeup.
Field
SMS Wakeup Trigger
Description
•
Feature Disabled
•
Any class 0 message—Device wakeup triggered on receipt of any class SMS message
•
0 Wake Command—Device wakeup triggered on receipt of class 0 message contained specific “wake command” text
•
Any SMS message—Device wakeup triggered on receipt of any SMS message
•
Wake Command—Device wakeup triggered on receipt of any SMS message containing “wake command” text
Note: Wakeup period is set under WAN/Cellular — Idle time before disconnect.
Rev. 6 May.13
Notes:
•
Every time there is data communication, the timer (Idle time before disconnect) resets.
•
If an SMS Wakeup trigger is received while the device is awake, the time resets.
•
When the device is in SMS Wakeup mode, it can still be woken up by
AT*RADIO_CONNECT=1, and put to sleep by AT*RADIO_CONNECT=0
•
If the device is woken up by the AT Command, a Wakeup SMS still triggers the timer and the device shuts down after the specified time expires.
103
ALEOS User Guide
•
If you select a trigger option that requires a specified message and the message does not match, the message is processed normally. This allows the device to receive information such as status or GPS position while this feature is enabled.
SMS Radio Module Configuration Settings
On some carriers’ networks, SMS will not work using the default radio module configuration. This feature, which is applicable only to the Raven XE (models
H2295E or H2225E) allows the user to change the radio module configuration to enable SMS, and is the same as issuing the AT command: “at*CGSMS=n”.
The default setting for the radio module is 3.
The configuration setting in ACEmanager is on the Services/SMS subtab,
Advanced section. Configuration options are shown in the following figure.
104
Figure 8-6: ACEmanager: Services > SMS > Advanced
SMS Routing
With this feature, you can access multiple devices connected by Ethernet (LAN) using SMS. To use this feature, host devices on the LAN must have static IP addresses.
4112515
Services Configuration
LAN
Ethernet
AirLink device
WAN
SMS
External Host
Devices
Figure 8-7: SMS Routing Network Configuration
SMS Routing—Incoming Messages
Incoming SMS messages have a new field in the message body:
IP <HOST IP> <message>.
SMS Routing—Outgoing Messages
Outgoing messages have the sender’s IP address inserted into the message before the message body. Message syntax is the same as for Incoming
Messages.
SMS Routing for Outgoing messages must be enabled in ACEmanager.
1.
Go to Services > SMS, and click SMS Send.
2.
In the SMS Send Enable drop-down menu, select Include IP.
Rev. 6 May.13
Figure 8-8: ACEmanager > Services > SMS > SMS Send
SMS Routing—LAN Side Communication
For the AirLink device to communicate with a host side (customer) device over the
LAN, both network interfaces must be configured with a static IP address. The
AirLink device and the host side device communicate using a peer-to-peer protocol over UDP.
The AirLink device sends the SMS content to the host devices encapsulated in a
UDP packet. The AirLink UDP packet is addressed to port 17342.
105
ALEOS User Guide
The AirLink device receives SMS content from the host side device encapsulated in a UDP packet. The customer (host side) UDP packet should be addressed to port 17341.
The message format for the UDP packet is:
<start> Phone # <separator> Data Type <separator> Payload Len <separator>
<Message Body> <end>
Note:
•
The same message format is used for incoming and outgoing messages
•
All bytes are ASCII text
•
<start>, <separator>, and <end> are delimiters
Example: You want to send the following message: “Test message” to phone number (510) 624-4200. To use this feature, convert the message to hex:54657374206d657373616765. Then format the message as follows:
<<<15106244200,ASCII,12,54657374206d657373616765>>> where:
•
“<<<” is the opening delimiter
•
“,” is the delimiter between fields
•
“ASCII” indicates that the message is ASCII encoded
•
“12” is the message length
•
“54657374206d657373616765” is the message itself
•
“>>>” is the closing delimiter
SMS Password Security
Only people with security access can send SMS commands to a device. This feature enables you to specify a password to be used with SMS commands, or you can use the ALEOS default password. The default password is generated from the SIM ID (for GSM devices) or the ESN (for CDMA devices).
To set the SMS password:
1.
Go to Services > SMS > SMS Security.
2.
Enter the desired password in the SMS Password field.
3.
Click Apply.
106
Figure 8-9: ACEmanager > Services > SMS > SMS Security
Note: The SMS password is not cleared by a configuration reset.
4112515
Services Configuration
SMS Address Type and Numbering Plan
This feature enables you to specify the SMS Address Type and SMS Address
Numbering Plan for sending SMS messages. The Address Type and Numbering
Plan you select are only used when the AirLink device initiates the SMS messages exchanges. If the SMS message originates from the head end, then
ALEOS uses whatever Address Type and Numbering Plan that are used in the head end message.
1.
On the Services tab, select SMS > Advanced.
Figure 8-10: ACEmanager > Services > SMS > Advanced
Field
SMS Address Type
Address Numbering
Plan
Description
•
Unknown (0 or 000)
•
International Number (1 or 001)
•
National Number (2 or 010)
•
Network Specific Number (3 or 011)
•
Subscriber Number (4 or 100)
•
Abbreviated Number (6 or 110)
•
Default: International Number (1 or 001)
•
Unknown (0 or 0 0 0 0)
•
ISDN/telephone numbering plan (1 or 0001)
•
Data numbering plan (3 or 0011)
•
Telex numbering plan (4 or 0100)
•
National numbering plan (8 or 1000)
•
Private numbering plan (9 or 1001)
•
ERMES numbering plan (10 or 1010)
Default: ISDN/telephone numbering plan (1 or 0001)
AirLink SMS Protocol
There are two new AT commands:
•
at*smsm2m_8 — for 8 bit data mode.
•
at*smsm2m_u — for unicode.
Unlike at*smsm2m, the data following the phone number must be a hex string.
The hex string is converted to bytes before sending.
For example:
Rev. 6 May.13
107
