User`s guide

Chapter 1 – AT Commands for Remote SIM Application Toolkit
Multi-Tech Systems, Inc. SIM Application Toolkit AT Commands (S000391C) 20
1.4.4 AT^SSTGI Remote-SAT Get Information – Set up Call (16)
Write command
AT^SSTGI=16
This command is to be used upon receiving an unsolicited result code ^SSTN:16.
If the SIM Application attempts to set up a call, it uses this response to inform the TA of
the call parameters. The sequence of events is as follows:
1. After the Remote-SAT notification 16 was issued, the TA has to request the
command parameter using AT^SSTGI=16.
2. If the SIM Application does not supply a confirmation text or icon parameter, the TA
gives other information to the user; e.g., phone number. In this case refer to step 4.
3. If the SIM Application supplies a non empty confirmation text or icon parameter,
the TA uses only these to ask the user whether or not he wishes to set up the call.
4. If the user confirms to set up the call, AT^SSTR=16,0 shall be responded.
5. If the user denies to set up the call, AT^SSTR=16,34 shall be responded.
6. After the confirmation phase, the TA may present a dialing animation on the screen
until a mandatory parameter line ^SSTR: 16, <TermQualifier>,
<TerminationCauseText> is issued.
7. If <TermQualifier> is not equal to 0, the dialing process didn’t perform successfully.
If <TerminationCauseText> is not an empty string, this text has to be shown to the
user for an appropriate time; e.g., 2 seconds. The text contains information about
dial termination cause; e.g., call barring through Call Control by SIM mechanism.
If <TerminationCauseText> is an empty string, the TA shall give an own indication
to the user.
8. If <TermQualifier> is equal to 0, the dial process has been successfully finished:
If <TerminationCauseText> is not an empty string, this text shall be used to inform
the user during the call setup.
If <TerminationCauseText> is an empty string, <callSetupText> and/or
<confirmationIconId> shall be used to inform the user during call setup.
However, if <callSetupText> contains no data, too, no indication shall be shown.
9. The TA shall give the user an opportunity to end an ongoing call set up by the
Proactive Command. In this case the, TA shall issue an ATH command to the ME.
Response
^SSTGI: <cmdType>, <commandDetails>, <confirmationText>,
<calledNumber>, <callSetupText>, <confirmationIconQualifier>, <confirmationIconId>,
<callSetupIconQualifier>,<callSetupIconId> <CR> <LF>
Parameters
<cmdType> 16 – Proactive command ID. See Table 1.
<commandDetails> Unsigned Integer, range 0 – 255, used as an enumeration:
0 Set up call, but only if not currently busy on another call.
1 Set up call, but only if not currently busy on another call with
redial.
2 Set up call, putting all other calls (if any) on hold.
3 Set up call, putting all other calls (if any) on hold with redial.
4 Set up call, disconnecting all other calls (if any).
5 Set up call, disconnecting all other calls (if any) with redial.
6...255 Reserved values.
<confirmationText> String for user confirmation stage
<calledNumber> String containing called number
<callSetupText> String for call set up stage
<confirmationIconQualifier> Unsigned Integer, range 0 – 255, used as a bitfield.
bit 1: 0 = Icon is self explanatory and replaces text
1 = Icon is not self-explanatory and shall be displayed
with the text
Determined value only if associated icon ID is not 0 (an
icon exists).
bits 2 to 8: = RFU
<confirmationIconId> 0-255, 0: No icon
<callSetupIconQualifier> Unsigned Integer, range 0 – 255, used as a bit-field.
bit 1: 0 = Icon is self explanatory and replaces text.
1 = Icon is not self-explanatory and shall be displayed
with the text.
Determined value only if associated icon ID is not 0 (an
icon exists).
bits 2 to 8: = RFU
<callSetupIconId> 0-255, 0: No icon