SIM Application Toolkit For the Following Multi-Tech Products External Wireless MultiModem® EDGE (MTCBA-E) External Wireless MultiModem® EDGE with USB (MTCBA-E-U) External Wireless MultiModem® EDGE with Bluetooth Interface (MTCBA-E-B) External Wireless MultiModem® EDGE with Ethernet Interface (MTCBA-E-EN) External Wireless MultiModem® EDGE with GPS Functionality (MTCBA-E-GP) Embedded Wireless SocketModem® EDGE (MTSMC-E) AT Commands Reference Guide
Copyright and Technical Support SIM Toolkit AT Command Reference Guide For the Following Multi-Tech Products External Wireless MultiModem® EDGE (MTCBA-E) External Wireless MultiModem® EDGE with USB (MTCBA-E-U) External Wireless MultiModem® EDGE with Bluetooth Interface (MTCBA-E-B) External Wireless MultiModem® EDGE with Ethernet Interface (MTCBA-E-EN) External Wireless MultiModem® EDGE with GPS Functionality (MTCBA-E-GP) Embedded Wireless SocketModem® EDGE (MTSMC-E) S000391C, Revision C Copyright This publi
Table of Contents Contents Chapter 1 – AT Commands for Remote SIM Application Toolkit 4 1.1 Introduction .......................................................................................................................................................4 1.1.1 Other Documentation ....................................................................................................................................4 1.1.2 Terms and Abbreviations .............................................................
Chapter 1 – AT Commands for Remote SIM Application Toolkit Chapter 1 – AT Commands for Remote SIM Application Toolkit This document presents the specification for AT commands and responses required for the SIM Application Toolkit (SAT) implementation. 1.1 Introduction SIM Application Toolkit (SAT) is a technology that lets the SIM card execute a great variety of additional applications.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.3 SAT Context Diagram 1.1.4 Usage of Remote-SAT Remote-SAT (RSAT) is designed as an AT interface which establishes the link between the SIM application running on the SIM card and the customer application (PDA, laptop, etc.). The purpose of RSAT is to allow the customer application to issue AT commands to the SAT interface and to display all SAT activities on the user interface of the customer application.
Chapter 1 – AT Commands for Remote SIM Application Toolkit Table 1 – Command Type Identifiers Command types supported by Remote-SAT (UI-related) ^SSTGI Used as Next ^SSTR value applicable Action Indicator required (decimal) Proactive Commands (TA Å ME Å SIM) Command Name Follows GSM 11.14 (version 8.5.0 2000-12) Section 13.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.6 Parameter Types Strings are passed as UCS2 characters, but using the GSM alphabet is also possible. It should be mentioned that the use of the GSM alphabet is not recommended since a SIM can contain text which might not be able to be displayed; e.g., Greek characters. To select the type of alphabet, use the AT^SSTA command. The type is determined both for inputs and outputs. UCS is specified in ISO/IEC 10646.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.7.1 Remote-SAT State Transition Diagram Multi-Tech Systems, Inc.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.7.2 Remote-SAT State Transition Table The following table outlines which AT commands can be issued during certain states. However, the test and read AT commands are available at any time. It is possible to determine the current state of the interface via AT^SSTA?. If a response contains text, the selected alphabet has to be used.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.9 Using SMS-Related AT Commands The SMS related AT commands follow the GSM 07.05 specification issued by ETSI. Usually, an SMS is sent to the network provider containing service requests; e.g., to send the latest news. The provider returns an SMS with the requested information. The application running on the TA sets the parameter specifying the input and output format of the received message. Example 1. Set SMS text mode AT+CMGF=1 2.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.10.2 Proactive Command Sequence After receiving a proactive command (PAC) from the SIM, SAT enters the PAC state. The TA is informed that a PAC has been issued and is expected to respond with a request for further information. While in the PAC state, some forms of the AT^SSTR commands can be issued. Upon receiving the AT^SSTGI command, SAT changes to the WAIT state.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.10.3 Envelope Command Sequence (Menu Selection) A SIM application will provide SAT with a main menu to display, using the PAC SETUP MENU. The envelope command MENU SELECTION allows the TA to select an item from this menu using AT^SSTR. When this takes place, SAT will issue a response to the user, but it will not change the state. The SIM application is then generally expected to issue a PAC. Multi-Tech Systems, Inc.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.10.4 Envelope Command Sequence (Call / MO / SMS Control) Envelope commands are issued for Call/MO control by the SAT if Call control is enabled. Upon receiving the response from the SIM application, SAT changes to the PAC state. In the PAC state, the TA is informed of the pending information and expected to issue AT^SSTGI to request further information.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.1.10.5 Event Download Sequence When an event occurs that is in the TA event list, as configured using the PAC SETUP EVENTLIST, SAT is informed using AT^SSTR. SAT creates the envelope command to send to the SIM application and responds to the TA. During this operation, SAT remains in the IDLE state. Multi-Tech Systems, Inc.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.2 AT^SSTA Remote-SAT Activation Test command AT^SSTA=? Response ^SSTA:(list of supported s), (list of supported s) See below for parameter description. Read command AT^SSTA? The read command can be used to request the current operating status and the alphabet used by the Remote-SAT interface. State handling is described in section 1.1.7.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.3 ^SSTN Remote-SAT Notification Proactive Commands Every time the SIM application issues a proactive command via the ME, the TA will receive a notification. This indicates the type of proactive command issued. AT^SSTGI must be used by the TA to request the parameters of the proactive command from the ME.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4 AT^SSTGI Remote-SAT Get Information 1.4.1 AT^SSTGI Remote-SAT Get Information – Generic Format Test command AT^SSTGI=? Response ^SSTGI:(list of supported s), (list of supported s) OK Read command AT^SSTGI? Response ^SSTGI: , OK Parameters Remote-SAT interface states (refer to AT^SSTA) Ongoing proactive command (values see Chapter 1.1.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.2 AT^SSTGI Remote-SAT Get Information – Refresh (1) Write command AT^SSTGI=1 This command is to be used upon receiving a URC ^SSTN:1. The response from the module indicates the type of SIM refresh taking place. Response ^SSTGI: , Parameters 1 Proactive command ID, see Table 1 Unsigned Integer, range 0 – 255, used as an enumeration.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 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.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.5 AT^SSTGI Remote-SAT Get Information – Send SS (17) Write command AT^SSTGI=17 This command is to be used upon receiving an unsolicited result code ^SSTN:17. The module is sending a supplementary service request to the network and is alerting the user of this. Text and an icon identifier can be passed to the TA to display to the user. Text and an icon identifier can be passed to the TA to display to the user.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.7 AT^SSTGI Remote-SAT Get Information – Send Short Message (19) Write command AT^SSTGI=19 This command is to be used upon receiving an unsolicited result code ^SSTN:19. The SIM Application is sending a Short Message and the TA is informed of this. The user can be passed a string containing information to display.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.9 AT^SSTGI Remote-SAT Get Information – Launch Browser (21) Write command AT^SSTGI=21 This command is to be used upon receiving an unsolicited result code ^SSTN:21. If the SIM Application attempts to start an Internet Browser, it uses this response to inform the TA of the launch parameters. The sequence of events is as follows: 1. After the Remote-SAT notification 21 ias issued, the TA has to ask for the command parameters via AT^SSTGI=21. 2.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.10 AT^SSTGI Remote-SAT Get Information – Play Tone (32) Write command AT^SSTGI=32 This command is to be used upon receiving an unsolicited result code ^SSTN:32. The ME has been instructed to generate an audible tone and may pass to the TA some information to support this. Text and an icon identifier are passed to the TA for display to the user.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.11 AT^SSTGI Remote-SAT Get Information – Display Text (33) Write command AT^SSTGI=33 This command is to be used upon receiving an unsolicited result code ^SSTN:33. The TA is being passed a message to display to the user, which can have different display characteristics. Text and an icon identifier can be passed to the TA to be displayed.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.12 AT^SSTGI Remote-SAT Get Information – Get Inkey (34) Write command AT^SSTGI=34 This command is to be used upon receiving an unsolicited result code ^SSTN:34. The TA is asked to prompt the user for an input, which is a single character. Help can be requested by the user, if available. Text and an icon identifier can be passed to the TA to display to the user.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.13 AT^SSTGI Remote-SAT Get Information – Get Input (35) Write command AT^SSTGI=35 This command is to be used upon receiving an unsolicited result code ^SSTN:35. The TA is asked to prompt the user for an input of a specified length and type; e.g., digits only. Help can be requested by the user, if available. Text and an Icon Identifier can be passed to the TA to be displayed to the user.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.14 AT^SSTGI Remote-SAT Get Information – Select Item (36) Write command AT^SSTGI=36 This command is to be used upon receiving an unsolicited result code ^SSTN:36. The TA is supplied with a list of items allowing the user to select one. Help can be requested by the user, if available, and the presentation style is specified.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.15 AT^SSTGI Remote-SAT Get Information – Set up Menu (37) Write command AT^SSTGI=37 This command is to be used upon receiving an unsolicited result code ^SSTN:37. However, please refer to note below. The response provides the main menu of the SIM Application to the TA. It will be stored by the TA so that it can be displayed without invoking a proactive session.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.4.16 AT^SSTGI Remote-SAT Get Information – Set up Idle Mode Text (40) Write command AT^SSTGI=40 This command is to be used upon receiving an unsolicited result code ^SSTN40. However, please refer to note below. It provides text and, optionally, an icon to be displayed by the TA when the display is Idle. Response ^SSTGI: , , , , Parameters 40 – Proactive command ID.
Chapter 1 – AT Commands for Remote SIM Application Toolkit Response Parameters 0 1 - 255 0 1 2-255 250 – Command ID. See Table 1. This byte is RFU. Unsigned Integer, range 0 – 255. Request number of icons on SIM only. Response parameters which follow are not listed. Icon ID.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.5 AT^SSTR Remote-SAT Response – Generic Format Test command AT^SSTR=? Response ^SSTR:(list of supported s), (list of supported s) OK Read command AT^SSTR? Response ^SSTR: , OK Parameters Write command AT^SSTR= , [,] [,] Remote-SAT interface states (refer to AT^SSTA) Ongoing proactive command (for values, see section 1.1.5).
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.5.1 Remote-SAT Command Status The following status values give a response to a previously issued Proactive command and are used by the AT Command AT^SSTR. The status parameter is used to identify the type of response from the TA to the ME. This table is based upon GSM 11.14.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.5.2.3 AT^SSTR Remote-SAT Response – Setup Call (16) Write Command AT^SSTR=16, The TA indicates if the call setup has been accepted by the user. For further details, please see section 1.4.4 Response After the confirmation phase, the TA may show a dialing animation on the screen until a mandatory response parameter is issued.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.5.2.6 AT^SSTR Remote-SAT Response – Send Short Message (19) Write Command AT^SSTR=19, The TA acknowledges the successful receipt of the proactive command. Response OK Parameters 19 – Proactive command ID. See Table 1. Unsigned Integer, range 0-255. 0 Command performed successfully. 32 TA currently unable to process command. 132 TA currently unable to process command because screen is busy.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.5.2.10 AT^SSTR Remote-SAT Response – Display Text (33) Write Command AT^SSTR=33, The TA can respond with a move through proactive session or provide additional information. Response OK Parameters 33 – Proactive command ID. See Table 1. Unsigned Integer, range 0-255. 0 Command performed successfully. 16 Proactive SIM session terminated by user. 17 Backward move in the proactive SIM session requested by the user.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.5.2.12 AT^SSTR Remote-SAT Response – Get Input (35) Write Command AT^SSTR=35, , , The TA provides a response that can indicate the user's intentions and include the input key. Response OK Parameters 35 – Proactive command ID. See Table 1. Unsigned Integer, range 0-255. 0 Command performed successfully. 16 Proactive SIM session terminated by user.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.5.2.14 AT^SSTR Remote-SAT Response – Set Up Menu (37) Write Command AT^SSTR=37, Note As with every proactive command the TA is expected to acknowledge the ^SSTGI response with AT^SSTR to confirm that the proactive command has been executed. The response simply conveys, to the SAT, the information that the main menu was received and set up on the user interface.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.5.3 Event Response Commands The following types of responses are neither issued in reaction to a formerly given notification (^SSTN) nor an AT^SSTGI sequence. These responses are intended to report activities of the external application; e.g., when the user is pressing a key. 1.5.3.
Chapter 1 – AT Commands for Remote SIM Application Toolkit 1.5.3.5 AT^SSTR Remote-SAT Event Response – Browser Termination (236) Write Command AT^SSTR=236, , Sent by the customer application to indicate that the Internet browser application has been terminated. Response OK Parameters 236 – Proactive command ID. See Table 1. Unsigned Integer, range 0-255. Browser Termination Cause. 0 User termination. 1 Error termination. 1.5.3.
Appendix A – SAT Profile Appendix A – SAT Profile The SAT Profile download is used by the ME as a means of telling the SIM of its capabilities. The profile download instruction is sent to the SIM from the ME as part of the SIM initialization process. The profile sent by the ME states which facilities the ME will support. The SIM adapts its behavior to the capabilities of the ME by reducing its instruction range. The AT command AT^SSTA is used to read the profile. See section 1.2.
Appendix A – SAT Profile Profile 3 Profile 4 Profile 5 Profile 6 Multi-Tech Systems, Inc.
Appendix A – SAT Profile Profile 7 Profile 8 Profile 9 Multi-Tech Systems, Inc.
Appendix B – UCS2 Character Set Options Appendix B – UCS2 Character Set Options 2.
Appendix C – Language Codes Appendix C – Language Codes 2.
Appendix C – Language Codes Language Gujarati Hausa Hebrew Hindi Hungarian Icelandic Indonesian Interlingua Interlingue Inuktitut Inupiak Irish Italian Japanese Javanese Kannada Kashmiri Kazakh Kinyarwanda Kirghiz Kirundi Korean Kurdish Laothian Lappish Latin Latvian (Lettish) Lingala Lithuanian Macedonian Malagasy Malay ISO Code gu ha iw, he hi hu is in, id ia ie iu ik ga it ja jw kn ks kk rw ky rn ko ku lo la lv ln lt mk mg ms Malayalam Maltese Manx Gaelic Maori Marathi Moldavian Mongolian ml mt gv mi
Appendix C – Language Codes Language Serbian Serbo-Croatian Sesotho Setswana Shona Sindhi Singhalese Siswati Slovak Slovenian Somali Spanish Sundanese Swahili Swedish Tagalog Tajik Tamil Tatar Telugu Thai Tibetan Tigrinya Tonga Tsonga Turkish Turkmen Twi Uighur Ukrainian Urdu Uzbek Vietnamese Volapük Welsh Wolof Xhosa Yiddish Yoruba Zulu ISO Code sr sh st tn sn sd si ss sk sl so es su sw sv tl tg ta tt te th bo ti to ts tr tk tw ug uk ur uz vi vo cy wo xh ji, yi yo zu Win Code 0x001a 0x001b 0x0024 0x000