8.16 Alarm +CALA

27.0073GPPAT command set for User Equipment (UE)Release 18TS

Table 76: +CALA parameter command syntax

Command

Possible response(s)

+CALA=<time>[,<n>[,<type>[,<text>[,<recurr>[,<silent>]]]]]

+CME ERROR: <err>

+CALA?

[+CALA: <time>,<n1>,<type>,[<text>],[<recurr>],<silent>]

[<CR><LF>+CALA: <time>,<n2>,<type>,[<text>],[<recurr>],<silent>

[…]]

+CME ERROR: <err>

+CALA=?

+CALA: (list of supported <n>s),(list of supported <type>s),<tlength>,<rlength>,(list of supported <silent>s)

+CME ERROR: <err>

Description

Set command sets an alarm time in the MT. There can be an array of different types of alarms, and each alarm may cause different text to be displayed in the MT display. If setting fails in an MT error, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values.

To set up a recurrent alarm for one or more days in the week, the <recurr>-parameter may be used.

When an alarm is timed out and executed, the unsolicited result code +CALV: <n> is always returned, even if the alarm is set up to be silent.

Read command returns the list of current active alarm settings in the MT.

Test command returns supported array index values, alarm types, and maximum length of the text to be displayed as compound values.

Defined values

<time>: refer +CCLK,+CSDF

NOTE: If the <recurr>-parameter is used, the <time>-parameter must not contain a date.

<n>, <n1>, <n2>: integer type value indicating the index of the alarm; default is manufacturer specific.

<type>: integer type value indicating the type of the alarm (e.g. sound, volume, LED); values and default are manufacturer specific.

<text>: string type value indicating the text to be displayed when alarm time is reached; maximum length <tlength>; values and default are manufacturer specific.

<tlength>: integer type value indicating the maximum length of <text>.

<recurr>: string type value indicating day of week for the alarm in one of the following formats (values and default are manufacturer specific):

"<1..7>[,<1..7>[…]]" Sets a recurrent alarm for one or more days in the week. The digits 1 to 7 corresponds to the days in the week, Monday (1), …, Sunday (7).

Example: The string "1,2,3,4,5" is used to set an alarm for all weekdays.

"0" Sets a recurrent alarm for all days in the week.

<rlength>: integer type value indicating the maximum length of <recurr>.

<silent>: Integer type value indicating if the alarm is silent or not. The defalt value is manufacturer specific.

0 the alarm will not be silent

1 the alarm will be silent and the only result from the alarm is the unsolicited result code +CALV

Implementation

Optional.