Chapter 14 – SIM Toolkit
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I)
143
SIM Toolkit Get Information +STGI
Description:
This command allows to get the information
(text to display, menu information, priorities…)
of a pro-
active command sent from the SIM.
The information is returned only after receiving a SIM Toolkit indication
(+STIN)
.
Values:
Values are listed after the Command Table
Syntax :
Command syntax:
+STGI=<CmdType>
Command
Possible responses
AT+STGI=<CmdType>
+CME ERROR: <err>
AT+STGI=? +STGI:
(0-11)
OK
Table of Command Types
Cmd
Type
Description
Possible responses
0
Get information about
Setup Menu
pro-active command.
+STGI: <Alpha Identifier menu>
+STGI: <Id1>,<NbItems>,<Alpha Id1 Label>,<Help
Info>[,<NextActionId>]<CR><LF>
+STGI: <Id2>,<NbItems>,<Alpha Id2 Label>,<Help
Info>[,<NextActionId>]<CR><LF>
[…]]
No action expected from SIM.
1
Get information about
Display text
pro-active command.
+STGI: <Prior>,<Text>,<ClearMode>
No action expected from SIM.
2
Get information about
Get Inkey
pro-active command.
+STGI: <Format>,<HelpInfo>[,<TextInfo>]
SIM expects key pressed (+STGR).
3
Get information about
Get Input
pro-active command.
+STGI: <Format>,<EchoMode>,<SizeMin>,<SizeMax>,
<HelpInfo>[,<TextInfo>]
SIM expects key input (+STGR).
4
Get information about
Setupt call
pro-active command.
+STGI: <Type>,<CalledNb>,<SubAddress>,<Class>
SIM expects user authorization (+STGR).
5
Get information about
Play Tone
pro-active command.
+STGI: <ToneType>[,<TimeUnit>,<TimeInterval>,<TextInfo>]
No action.
6
Get information about
Sel Item
pro-active command.
+STGI: <DefaultItem>, <Alpha Identifier menu><CR><LF>
+STGI: <Id1>,<NbItems>,<Alpha Id1 Label>,<Help
Info>[,<NextActionId>]<CR><LF>
+STGI: <Id2>,<NbItems>,<Alpha Id2 Label>,<Help
Info>[,<NextActionId>]<CR><LF>
[…]]
SIM expects an item choice (+STGR).
7
Get information about
Refresh
pro-active command.
+STGI: <RefreshType>
No action (Refresh done automatically by product).
8
Get information about
Send SS
pro-active command.
+STGI:<TextInfo>
No action (Send SS done automatically by product).
9
Get information about
Send SMS
pro-active command.
+STGI: <TextInfo>
No action (Send SMS done automatically by product).
10
Get information about
Send USSD
pro-active command.
+STGI: <TextInfo>
No action (Send USSD done automatically by product).
11
Get information about
SETUP EVENT LIST
pro-active command.
+STGI: <Evt>
Values for the SIM Toolkit Get Information Command
:
Values when CmdType=0 (Setup menu)
<Alpha Idenitifer menu>
Alpha identifier of the main menu
<Idx> (1-255)
Menu item Identifier
<NbItems> (1-255)
Number of items in the main menu
<Alpha Idx Label>
Alpha identifier label of items in ASCII format
<HelpInfo>
0
No help information available
1
Help
information available
<NextActionId>
Contains a pro-active command identifier
(see the table in APPENDIX F)
Compared to other commands the customer application can always get information about setup menu after having
received the +STIN:0 indication.