> 3.2 | AT+CIND Indicator control

> The AT+CIND command controls the presentation of Indicator Event Reports related to various functions such as battery charge level, signal quality, service availability, sound generation, indication of unread short messages, full SMS storage, call in progress or roaming activities.
> Use of AT+CIND has become outdated. Rather we recommend the more powerful AT^SIND command which is easier to use and provides additional indicators. All indicators provided by AT+CIND can be handled with AT^SIND as well.
> AT+CIND supports two ways to get the values related to indicators:

> • | One approach is to query the current status of each indicator by using the read command AT+CIND?. It returns the status no matter whether the indicator has been registered with the write command AT+CIND=[<mode>[,<mode>[,...]]].

> • | The other way is an event-driven notification based on the "+CIEV" URCs. In this case, the ME will automatically send a message to the application, whenever the value of an indicator changes. The application should be designed to react adequately when receiving a URC. The presentation of these URCs depends on two settings:

> - | The indicators must be registered with the write command AT+CIND=[<mode>[,<mode>[,...]]]. When the ME is switched on all of them are in registered mode. Any indicator can be excluded if deregistered with <mode>=0. To register or deregister an indicator the AT+CIND write command requires to type the value <mode>=1 or 0 exactly at the position where the indicator is located in the list. This is not necessary with AT^SIND which allows to specify indicators by name. See examples below.

> - | The presentation of the registered indicators must be enabled with AT+CMER.

> Syntax

> Test Command AT+CIND=?
> Response(s)
> +CIND: (<indDescr>, list of supported <indValue>s)[, (<indDescr>, list of supported <indValue>s)[, ...]]
> OK

> Read Command AT+CIND?
> Response(s)
> +CIND: <indValue>[, <indValue>[, ...]]
> OK
> ERROR
> +CME ERROR: <err>

> Write Command AT+CIND=<mode>[, <mode>[, ...]]
> Response(s)
> OK
> ERROR
> +CME ERROR: <err>

> Reference(s) |  | PIN |  | ASC0 | ASC1 | USB | MUX1 | MUX2 | MUX3 |  |  | Charge | Q | Last
> GSM 07.07 |  | - |  | + | + | + | + | + | + |  |  | - | + | -

> Parameter Description

> <indValue>(num)

> Integer type value, which shall be in range of corresponding <indDescr>

> <indDescr>(str)

> String values and their <indValue> ranges.
> More indications are available via AT^SIND. Therefore use of AT^SIND for control of all indications is recommended.
> The following indications are accessible via AT+CIND:
> “battchg“
> Battery charge level 0..4 or 5 if no measuring is performed, e.g because no battery is connected. Also refer to AT^SBC.
> “signal“
> Signal quality (0..7)
> The indicated value is the bit error rate of the signal received. Bit errors are estimated values. To check the bit error rate there must be a call in progress to obtain realistic values. If no call is set up, there is no BER to be determined. See also AT+CSQ.
> “service“
> Service availability (0-1)
> 0: Not registered to any network
> 1: Registered to home network or, if "roam"=1 then registered to another network
> “sounder“
> Sounder activity (0-1)
> Reports every event that causes the ME to generate a tone.
> Value 1 means for example:
> Incoming call - ME is ringing. Note that the URC "+CIEV: sounder" will be output only if ringing tones are activated with AT^SRTC.
> Waiting call - ME generates waiting call tone (if call waiting is enabled).
> Outgoing call - ME generates Call Progress tone.
> Outgoing call - ME generates BUSY tone.
> The value changes to 0 when the tone stops.
> “message“
> Unread short message at memory location <mem1> (0-1); refer to AT+CPMS
> “call“
> Call in progress (0-1). Indicator value is "1" if at least one call is in state "active" or "held".
> Depending on the parameter <succ> selected with AT^SCFG the indicator "call" will be issued

> • | when a state transition ends in state "active" or state "unknown", if <succ>="restricted",

> • | when any state transition (including transitions beginning or ending in state "unknown") occurs in the list of active calls or when a traffic channel is established, if <succ>="verbose".

> Also refer to Section 7.1, Call Status Information.
> “roam“
> Roaming indicator (0-1)
> 0: Registered to home network or not registered
> 1: Registered to other network
> “smsfull“
> A short message memory storage in the MT has become full (1) or memory locations are available (0), i.e. range is (0-1)
> “rssi“
> Received signal (field) strength (0..5)
> 0: signal strength < -112 dBm
> 1-4: signal strength in 15 dB steps
> 5: signal strength > -51 dBm
> Received signal (field) strength can also be obtained with AT+CSQ. However, the signal strength is scaled to value range 0..31 by this command.

> <mode>(num)

> 0
> Indicator is deregistered. The indicator will not be presented as "+CIEV" URC, but can be queried with AT+CIND?.
> [1](&F)(P)
> Indicator is registered, indicator event report allowed.
> Notes

> • | Due to its restrictive value range, indicator "call" does not clearly reflect specific call states (such as alerting, active, held etc.), but rather serves to trigger the application to retrieve the new call status from the list of current calls with the AT commands AT^SLCC, AT+CLCC or AT^SCNI.

> • | If AT^SCFG setting <succ>="verbose", indicator "call" will be issued also when a traffic channel is established, or when a call enters states "terminating" or "dropped" (see Call Status Information). In these cases, the relevant information about the cause of the display is available only from AT command AT^SLCC.

> Examples

> EXAMPLE 1 |

> ^SYSSTART
> AT+CPIN=9999
> OK
> AT+CIND?
> +CIND: 5,0,1,0,0,0,0,0 | The battery is either full or no battery is connected to the ME. The bit error rate of the signal quality is not available (since there is no call in progress). The ME is registered to its home network.
> OK
> AT+CMER=2,0,0,2 | Now activate the Indicator Event Report with AT+CMER.
> OK
> +CIEV: battchg,5
> +CIEV: signal,0
> +CIEV: service,1
> +CIEV: sounder,0
> +CIEV: message,0
> +CIEV: call,0
> +CIEV: roam,0
> +CIEV: smsfull,0
> +CIEV: rssi,5 | Full receive signal strength.
> ATD0123456; | Make a call.
> OK
> +CIEV: sounder,1 | A set of "+CIEV" URCs is received.
> +CIEV: call,1
> +CIEV: sounder,0
> +CIEV: call,0 | Called party hangs up.
> NO CARRIER
> AT+CIND=,,,0,,0 | Deregister the indicators "sounder" and "call".
> OK
> ATD0123456; | Dial the same call.
> OK | This time, no URCs are displayed.
> NO CARRIER | Called party hangs up.

> EXAMPLE 2 | Deactivation of indicator "sounder" via AT+CIND

> AT+CIND? | Query the current status of indicators.
> +CIND: 5,0,1,0,1,0,0,0,4
> OK
> AT+CIND=,,,0 | To deactivate indicator "sounder" (= fourth item in list of indicators).
> OK

> EXAMPLE 3 | Deactivation of indicator "sounder" via AT^SIND

> AT^SIND="sounder",0 | To deactivate indicator "sounder".
> ^SIND: sounder,0,0
> OK