User guide

Developers guidelines | AT commands
225 June 2010
AT+CALA Alarm (ver. 3)
Description: Sets an alarm time in the ME. There can be an array of different alarms.
Each alarm may be recurrent. If setting fails in an ME error, +CME ERROR:
<err> is returned. When the alarm is timed out and executed, the
unsolicited result code +CALV: <n> is always returned, even if the alarm is
setup to be silent.
The alarm time is set in hours and minutes. Date, seconds and time zone
are not used.
The read command returns the list of current active alarm settings in the
ME.
The test command returns supported array index values, alarm types and
maximum length of the text strings.
Note: Parameters that are not supported should be left empty between the
comma signs.
Example: To set a recurrent alarm for alarm position 3 (Monday to Friday):
AT+CALA=”11:15”,3,1,,”1,2,3,4,5”
The <text> parameter is omitted because it is not supported.
Set command: AT+CALA=<time>[,<n>[,[<type>],[<text>],<recurr>[,<silent>]]]
Read command: AT+CALA?
Read command
response [+CALA: [<time1>,<n1>,<type1>,[<text1>],[<recurr1>],<silent1>]
[+CALA: <time2>,<n2>,<type2>,[<text2>],[<recurr2>],<silent2>]
Test command: AT+CALA=? Shows if the command is supported.
Test command
response: +CALA: (list of supported <n>s),(list of supported
type>s),<tlength>,<rlength>,(list of supported <silent>s)
Parameters:
<time>: String. Only hours and minutes of format “HH:MM” are used. Date, time
zone and seconds are not used.
<n>: Integer. Index identifying an alarm position. It is phone specific how many
alarms there could be in the phone.
<type>: Integer. Value indicating the type of alarm.
<type> Description
0 RECURRENT ALARM
1 TIME
<text>: Text to be displayed when the alarm time is reached.
<tlength>: Integer. Maximum length of the <text> parameter. Maximum value=20.
<recurr>: