User guide

Developers guidelines | AT commands
62 June 2010
AT*SELERT SEMC create alert (information text)
Description: Displays an alert dialog via the phone UI. An alert is a dialog that shows
data to the user and waits for the user to respond to the information. An
alert can contain text (string) and an icon. Alerts inform the user about
errors and other exceptional conditions.
When calling AT*SELERT with a timeout (<alert_type> = 6) and the given
amount of time has elapsed, an unsolicited result code *SEGUII is sent to
the accessory.
The dialog is not be removed when the timeout has been reached. It is the
callers responsibility to listen to the unsolicited result code and act upon it.
If a user presses the left softkey (OK), *SEGUII is also sent.
To be able to use this command, a UI session has to be established. That
is, the AT command AT*SEUIS=1 has to be called before calling
AT*SELERT. An alert dialog is deleted if AT*SEDEL=<object_index> is
called or the UI session connected to the object is destroyed
(AT*SEUIS=0).
Set command: With <alert_type> <= 5:
AT*SELERT=<alert_text>,<alert_type>,<show>[,<title>][,<time_out>]
[,<image>]
With <alert_type> = 6:
AT*SELERT=<alert_text>[,[<alert_type>],[<show>],[<timeout>]]
Set command
response: *SELERT:<object_index>
Test command: AT*SELERT=? Shows if the command is supported.
Test command
response: Range of general parameters:
*SELERT: ((list of supported <alert_type>s),(list of supported <show>s),(list
of supported <timeout>s),(list of supported <icon_id>s)
Parameters:
<title>:
<title> Description
String Title of the alert.
Note: Not valid for <alert_type> = 6 (Text feedback)
<alert_text>:
<alert_text> Description
String Text to be included in the alert
<alert_type>:
<alert_type> Description
0 NONE
1 ALARM
An ALARM AlertType alerts the user to an event for
which the user has previously requested to be noti-
fied. For example, the message might say, “Staff
meeting in five minutes”