Specifications

Chapter 18 – Hardware-Related Commands
Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B) 226
18.2 AT+CALA Set Alarm Time
Description: The write command sets an alarm time in the ME or clears a programmed alarm. When the
alarm time is reached and the alarm is executed, the ME returns an Unsolicited Result Code
(URC) and the alarm time is reset to “00/01/01,00:00:00”.
The alarm can adopt two functions, depending on whether or not you switch the GSM engine off
after setting the alarm:
• Reminder message: You can use the alarm function to generate reminder messages. For
this purpose, set the alarm as described below and do not switch off or power down the
ME. When executed, the message comes as an Unsolicited Result Code, which reads
“+CALA”.
• Airplane mode: The alarm function can be used to wake up the ME at a scheduled time.
For this purpose, set the alarm as described below. Then power down the ME by entering
the AT^SMSO command. When the alarm time is reached the ME enters the Airplane
mode, notified to the user by the URC "^SYSSTART AIRPLANE MODE" and, if available,
by a user defined text message (specified with <text>). In Airplane mode, the RF interface
of the ME is shut down to prevent it from unintentionally logging into the GSM network. All
AT commands whose execution requires a radio connection are disabled. A list of AT
commands supported during Airplane mode can be found in Section 20.4, Availability of
AT Commands Depending on Operating Mode of ME. To return from Airplane mode to
Normal mode use the AT^SCFG command and set the parameter <map> to "off". This
immediately activates the RF interface and restores access to all AT commands. The
URC "^SYSSTART" notifies the user that the ME has returned to Normal mode. Please
note that setting an alarm with AT+CALA is one method to wake up into Airplane mode.
The second approach is using the AT^SCFG command, parameter <mapos>. For further
detail on Airplane mode refer to Section 2.14, AT^SCFG.
The test command returns supported array index values <n>, alarm types <type>, and the
maximum length of the text <tlength> to be output.
The read command returns the list of current alarm settings in the ME.
Test Command Syntax: AT+CALA=?
Response: +CALA: (list of supported<n>s), (list of supported<type>s), (list of supported<tlength>s)
OK
ERROR
+CME ERROR: <err>
Read Command Syntax: AT+CALA?
Response: +CALA: <time>[, <n>[, <type>[, <text>]]]
OK
ERROR
+CME ERROR: <err>
Write Command Syntax: AT+CALA=<time>[, <n>[, <type>[, <text>]]]
Response: OK
ERROR
+CME ERROR
Unsolicited Result Codes:
+CALA: <text> Indicates reminder message.
After power-down and wake-up at the scheduled time, the following URC indicates that the ME has entered the
Airplane mode:
"^SYSSTART AIRPLANE MODE"
+CALA: [<text>]
Parameter Descriptions:
<time>
Format is “yy/MM/dd,hh:mm:ss”. For example, 6
th
of July 2005, 22:10:00 hours equals to “05/07/06,22:10:00”
(see also AT+CCLK). Note: if <time> equals current date and time or is set to an earlier date, TA returns +CME
ERROR: 21. To clear a given alarm before its scheduled time, simply enter an empty string for parameter
<time>.
<n>
Integer type value indicating the array index of the alarm.
The ME allows to set only one alarm at a time. Therefore, the list of supported alarm events indicated by the test
command AT+CALA=? is <n>=0. If a second alarm time is set, the previous alarm will be deleted. Therefore, the
read command AT+CALA? will always return <n>=0. This is also true if individual settings are made on ASC0 or
the various Multiplexer channels. For details, see notes below.