User manual
Confidential, the whole present document is the sole property of Maestro Wireless Solution Ltd.
66
20 COMMAND STRING – SERVICES
“Service” is a kind function or tool that can be made use by Command String. There are two kinds of Services:
Trigger capable
When a certain pre-defined condition is matched (e.g. timer reach zero) “trigger” a stored Command String.
These Services include: Alarm, Counter, Input Port, and Countdown Timer
Non-Trigger capable
Can only perform job when called by Command String.
These Services include: SMS
20.1 Alarm Service
Alarm is used to execute a Command String when the real-time clock of the M100 2G meets the set time of the Alarm.
To use Alarm it is required to set the real-time clock of the modem properly, see AT+CCLK in AT command manual.
There are total of 5 Alarms can be used.
20.1.1 Alarm Service Command String Syntax and explanation
1
st
field
Service
type
2
nd
field
Service
id
3
rd
field
Operation
type
4
th
field
Operation argument
Explanation
AL
(1 to 5)
ST
09/10/10,12:00:00
Set alarm date/time
yy/mm/dd,hh:mm:ss format
ST
0
Cancel preset
TR
(1 to 50)
0
Set Command String to be run,
0 to cancel setting
Example: Set alarm #1 to execute Command String #20 at 01OCT2008, 01:00:00
AL 1 TR 1 AL 1 ST 08/10/01,01:00:00
Example: Cancel #1 Alarm setting
AL 1 ST 0
Example: Cancel #1 Alarm executing Command String
AL 1 TR 0
Note
:
The Alarm date time input MUST to fulfill the following requirements:
1. In yy/mm/dd,hh:mm:ss format, program will also check if input date/time is valid or not
2. At least 4 minutes later than current modem’s real-time clock time (check by AT+CCLK command)
Do not concatenate after
ST
operation; set time operation should be at the last part of Command String
After alarm time, the
ST
setting of that Alarm will be lost
This service will make use of M100 2G internal alarm command (AT+CALA) so please avoid using AT+CALA
command by yourself when Alarm Service is used.
If the modem is restarted, date time setting of each Alarm will be checked against real-time clock time. If time is
passed the setting will be cancelled.
Alarm Service is “one-shot” type. There is no periodic alarm like “daily” or “weekly”
20.1.2 Reading Alarm Service Status
See Chapter 21for details.