User guide

Developers guidelines | AT commands
71 June 2010
AT*SEGAUGE SEMC create gauge (bar graph/progress feedback)
Description: Creates a gauge (progress feedback).
If the gauge is interactive with <interactive>=1 and the user has changed
the value of the gauge, the unsolicited result code *SEGUII is sent. This
also happens if the user cancels the gauge.
If <interactive> = 2 then the user (accessory) has the ability to update the
gauge via the AT*SEGUP command.
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*SEGAUGE.
A gauge object is deleted if AT*SEDEL=<object_index> is called.
Execution
command: AT*SEGAUGE=<label>,<interactive>,<show>[,<form>[,<initial_value>[,<
maxvalue>]]
Execution command
response: *SEGAUGE:<object_index>
Test command: AT*SEGAUGE=? Shows if the command is supported.
Test command
response: Range of general parameters:
*SEGAUGE: 0, (list of supported <show>s), (list of supported <form>s)
*SEGAUGE: 1, (list of supported <show>s),(list of supported <form>s),(list
of supported <initial_value>s)
*SEGAUGE: 2, (list of supported <show>s),(list of supported <form>s),(list
of supported <initial_value>s),(list of supported maxvalues)
Parameters:
<label>:
<label> Description
String Item label
<interactive>:
<interactive> Description
0 Non-interactive mode. The user cannot change the
value of the bar graph. The gauge is used as a
“progress feedback”.
Initial_value and maxvalue ignored
1 Interactive mode – to update the value of the gauge
use the AT command AT*SEGUP. Used by, for
example, accessories that want to control a
progress feedback by themselves.
Maxvalue ignored
2 Interactive mode – the user is allowed to modify the
value of the gauge by using the keyboard.
The accessory will be notified when the gauge has
been updated via *SEGUII
<maxvalue>:
<maxvalue> Description
Integer The maximum value of the gauge. In range [1–28]