Siemens Network Router Mc35 Users Manual Version History.
MC35 to the manual b8943aa2-a216-4b30-9218-d9775f054575
2015-02-05
: Siemens Siemens-Network-Router-Mc35-Users-Manual-410378 siemens-network-router-mc35-users-manual-410378 siemens pdf
Open the PDF directly: View PDF .
Page Count: 65
Download | |
Open PDF In Browser | View PDF |
User's Guide MC35 Module MC35 Terminal Version: 02.00 DocID: MC35 SAT 01 v02.00 Remote-SAT User's Guide Document Name: Remote-SAT User's Guide Version: Date: DocId: Status: 02.00 11.01.2002 MC35_SAT_01_v02.00 Released General note With respect to any damages arising in connection with the described product or this document, Siemens shall be liable according to the General Conditions on which the delivery of the described product and this document are based. This product is not intended for use in life support appliances, devices or systems where a malfunction of the product can reasonably be expected to result in personal injury. Siemens AG customers using or selling this product for use in such applications do so at their own risk and agree to fully indemnify Siemens for any damages resulting from illegal use or resale. Applications incorporating the described product must be designed to be in accordance with the technical specifications provided in these guidelines. Failure to comply with any of the required procedures can result in malfunctions or serious discrepancies in results. Furthermore, all safety instructions regarding the use of mobile technical systems, including GSM products, which also apply to cellular phones must be followed. Handheld applications such as mobile phones or PDAs incorporating the described product must be in accordance with the guidelines for human exposure to radio frequency energy. The Specific Absorption Rate (SAR) of the application must be evaluated and approved to be compliant with national and international safety standards or directives. Subject to change without notice at any time. Copyright notice Copying of this document and giving it to others and the use or communication of the contents thereof, are forbidden without express authority. Offenders are liable to the payment of damages. All rights reserved in the event of grant of a patent or the registration of a utility model or design. Copyright © Siemens AG 2002 MC35_SAT_01_v02.00 Page 2 of 65 11.01.2002 Remote-SAT User's Guide Contents 1 AT Commands for Remote-SAT in MC35 .................................................................................. 5 1.1 Introduction.......................................................................................................................... 5 1.1.1 Supported product versions and related documents ........................................... 6 1.1.2 SAT Context Diagram .......................................................................................... 7 1.1.3 Usage of Remote-SAT......................................................................................... 8 1.1.4 Command Type Values ....................................................................................... 8 1.1.5 Parameter Types................................................................................................ 10 1.1.6 States of Remote-SAT ....................................................................................... 10 1.1.6.1 Remote-SAT State Transition Diagram ............................................................. 11 1.1.6.2 Remote-SAT State Transition Table .................................................................. 12 1.1.7 Examples: Using Remote-SAT .......................................................................... 13 1.1.8 Sequence scenarios........................................................................................... 15 1.1.8.1 Initialisation sequence........................................................................................ 15 1.1.8.2 Proactive Command sequence.......................................................................... 16 1.1.8.3 Envelope Command sequence (Menu Selection).............................................. 17 1.1.8.4 Envelope Command sequence (Call / MO / SMS Control) ................................ 18 1.1.8.5 Event Download sequence ................................................................................ 19 1.2 AT^SSTA Remote-SAT Activation .................................................................................... 20 1.3 ^SSTN Remote-SAT Notification....................................................................................... 22 1.4 AT^SSTGI Remote-SAT Get Information......................................................................... 23 1.4.1 AT^SSTGI Remote-SAT Get Information – Generic Format ............................ 23 1.4.2 AT^SSTGI Remote-SAT Get Information – Refresh (1) ................................... 24 1.4.3 AT^SSTGI Remote-SAT Get Information – Set Up Event List (5) .................... 25 1.4.4 AT^SSTGI Remote-SAT Get Information – Setup Call (16) ............................. 26 1.4.5 AT^SSTGI Remote-SAT Get Information – Send SS (17)................................ 28 1.4.6 AT^SSTGI Remote-SAT Get Information – Send USSD (18) .......................... 29 1.4.7 AT^SSTGI Remote-SAT Get Information – Send Short Message (19) ............ 30 1.4.8 AT^SSTGI Remote-SAT Get Information – Send DTMF (20) .......................... 31 1.4.9 AT^SSTGI Remote-SAT Get Information – Play Tone (32).............................. 32 1.4.10 AT^SSTGI Remote-SAT Get Information – Display Text (33) .......................... 33 1.4.11 AT^SSTGI Remote-SAT Get Information – Get Inkey (34) .............................. 34 1.4.12 AT^SSTGI Remote-SAT Get Information – Get Input (35) ............................... 35 1.4.13 AT^SSTGI Remote-SAT Get Information – Select Item (36)............................ 36 1.4.14 AT^SSTGI Remote-SAT Get Information – Setup Menu (37) .......................... 38 1.4.15 AT^SSTGI Remote-SAT Get Information – Setup Idle Mode Text (40) ........... 39 1.5 AT^SSTR Remote-SAT Response – Generic Format ...................................................... 40 1.5.1 Remote-SAT Command Status ......................................................................... 42 1.5.2 Proactive Commands......................................................................................... 43 1.5.2.1 AT^SSTR Remote-SAT Response – Refresh (1) ............................................. 43 1.5.2.2 AT^SSTR Remote-SAT Response – Set Up Event List (5).............................. 43 1.5.2.3 AT^SSTR Remote-SAT Response – Setup Call (16) ....................................... 44 1.5.2.4 AT^SSTR Remote-SAT Response – Send SS (17) ......................................... 45 1.5.2.5 AT^SSTR Remote-SAT Response – Send USSD (18) .................................... 46 1.5.2.6 AT^SSTR Remote-SAT Response – Send Short Message (19) ...................... 47 1.5.2.7 AT^SSTR Remote-SAT Response – Send DTMF (20) .................................... 48 1.5.2.8 AT^SSTR Remote-SAT Response – Play Tone (32) ....................................... 49 1.5.2.9 AT^SSTR Remote-SAT Response – Display Text (33).................................... 50 1.5.2.10 AT^SSTR Remote-SAT Response – Get Inkey (34) ........................................ 51 1.5.2.11 AT^SSTR Remote-SAT Response – Get Input (35)......................................... 52 1.5.2.12 AT^SSTR Remote-SAT Response – Select Item (36)...................................... 53 MC35_SAT_01_v02.00 Page 3 of 65 11.01.2002 Remote-SAT User's Guide 1.5.2.13 1.5.2.14 1.5.3 1.5.3.1 1.5.3.2 1.5.3.3 1.5.3.4 1.5.3.5 2 AT^SSTR Remote-SAT Response – Set Up Menu (37)................................... 54 AT^SSTR Remote-SAT Response – Set Up Idle Mode Text (40).................... 55 Event Response Commands ............................................................................. 56 AT^SSTR Remote-SAT Event Response – Menu Selection (211)................... 56 AT^SSTR Remote-SAT Event Response – User Activity (232)........................ 56 AT^SSTR Remote-SAT Event Response – Idle Screen Available (233).......... 57 AT^SSTR Remote-SAT Event Response – Language Selection (235)............ 57 AT^SSTR Remote-SAT Event Response – Terminate Command (254) ......... 57 Appendix..................................................................................................................................... 58 2.1 Appendix A – SAT Profile .................................................................................................. 58 2.2 Appendix B - UCS2 Character Set Options....................................................................... 61 2.3 Appendix C – Language Codes......................................................................................... 63 0 Version History This chapter reports modifications and improvements over previous versions of the document. "Remote-SAT User’s Guide" Version MC35_sat_01_v0101a=> MC35_SAT_01_v02.00 Chapter / AT command Page What is new 1.1.4, Table 1 9 Section “Termination of Proactive Commands (URCs, TA ← ME ← SIM)”:values 116 – 119 removed 1.4.3 AT^SSTGI Remote-SAT Get Information – Set Up Event List (5) 25 : “range 0-255” removed bit 9 – 16 (RFU) added 1.4.4 AT^SSTGI Remote-SAT 26 Get Information – Setup Call (16) Description of write command modified 1.4.9 AT^SSTGI Remote-SAT Get Information – Play Tone (32) 32 Parameters added 1.5 and 1.5.2.3 40 44 Syntax of write command response modified: ^SSTR: xy , replaced with: ^SSTR: , , MC35_SAT_01_v02.00 Page 4 of 65 11.01.2002 Remote-SAT User's Guide 1 AT Commands for Remote-SAT in MC35 This document presents the specification for AT commands and responses required for the SIM Application Toolkit (SAT) implementation in MC35. 1.1 Introduction SIM Application Toolkit (SAT) is a technology that lets the SIM card execute a great variety of additional applications. Conventionally, SIM cards are intended to store user specific data, such as phonebooks, secure user identification codes and messages, but they can also hold a lot of valueadded mobile applications. The SAT functionality integrated in MC35 and MC35T allows to execute network specific applications implemented on the SIM card. Typical examples are online banking and information services. The commands exchanged between SAT and the SIM application fall into two categories: • Proactive commands – sent from the SIM application to the module’s SAT, e.g. DISPLAY TEXT. • Envelope commands – sent from the module's SAT to the SIM application, e.g. MENU SELECTION. The SAT implementation supports SAT class 3, GSM 11.14 Release 98, no support of letter classes. GSM 11.14 describes Proactive and Envelope Commands in detail. Note: The part on PC or PDA side which handles the Remote-SAT AT command interface (referred to as SAT-IF-Handler) is available as an exemplary implementation guidance as source code. For details, please contact the Wireless Modules Application Engineering Department at Siemens AG. MC35_SAT_01_v02.00 Page 5 of 65 11.01.2002 Remote-SAT User's Guide 1.1.1 Supported product versions and related documents Please note that this document is intended for the MC35 software release 02.00. The SAT functions can be used in conjunction with the MC35 Cellular Engine and the MC35 Terminal. Related documents [1] AT Command Set for MC35 and MC35 Terminal, Version 02.00 [2] MC35 Hardware Interface Description, Version 02.00 [3] Release Notes: MC35 Version 02.00 [4] MC35 GPRS Startup User's Guide [5] Application Note 16: Updating MC35 Firmware, Version 02.00 [6] M35 Terminal Hardware Interface Description [7] TC35 MC35 Terminal User's Guide [8] Application Note 02: Audio Interface, as of Version 02.00 Prior to using MC35 / MC35T or upgrading to a new firmware release, be sure to carefully read and understand the latest product information provided in the Release Notes. To visit the Siemens Website you can use the following link: http://www.siemens.com/wm MC35_SAT_01_v02.00 Page 6 of 65 11.01.2002 Remote-SAT User's Guide 1.1.2 SAT Context Diagram Customer Application MC35 (Running PC-SAT application) MMI Air IF SAT-UI LCD KBD PC/PDA Remote-SAT SA algo SAT data ^SSTN: IDLE AT^SSTR: WAIT ^SSTN: PAC AT commands SAT-IF-Handler (Driver-DLL) SIM AT^SSTGI: MC35_SAT_01_v02.00 Page 7 of 65 11.01.2002 Remote-SAT User's Guide 1.1.3 Usage of Remote-SAT Remote-SAT (RSAT) is designed as an AT interface that forms 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 commands to the SAT interface and to display all SAT activities on the user interface of the customer application. To take advantage of Remote-SAT it must be explicitly started using the AT^SSTA command. If no customer application is involved there is no need to communicate through the AT interface, and Remote-SAT can be ignored. In this case, all commands and responses may be exchanged directly between the module's SAT interface and the GSM network. Both scenarios – whether or not Remote-SAT is activated – are illustrated in the context diagram in Chapter 1.1.2. As a cellular module does not have an MMI, RSAT differs from a phone implementation of SAT. It uses a special set of AT Commands to pass data, e.g. a list of menu items, to the TA and to receive responses, e.g. a selected menu item. The TA, being the customer application, is required to implement a state machine that controls the module's SAT. It monitors the states of SAT and sends appropriate AT commands when required, depending upon user input. As an example of a proven implementation approach, the SIEMENS PCMMI tool is available on request. If the TA does not offer the SIM Application Toolkit to the end user, e.g. online banking, information services, then the module does not place any requirements on the TA for additional support. Therefore the state machine and the use of RSAT AT commands do not need to be implemented in the TA. 1.1.4 Command Type Values The Command Type value ( ) identifies the type of command or associated response passed between the TA (customer application) and the ME. ) is the parameter that comes first in AT commands, in response to AT^SSTGI (see Chapter 1.4) and AT^SSTR (see Chapter 1.5), and in the ^SSTN unsolicited result code (see Chapter 1.3). The SAT implementation supports SAT class 3 (GSM 11.14 Release 98, no support of letter classes). Therefore, Table 1 summarizes only those command types and parameters which may appear on the user interface (UI) and thus, allow the user to take an action. Command types that are transparent to the user are not listed in the table, although they are supported by Remote-SAT as specified in GSM 11.14. MC35_SAT_01_v02.00 Page 8 of 65 11.01.2002 Remote-SAT User's Guide Table 1 Command Type Identifiers Command Types supported by Remote-SAT (i.e. UI related) value (decimal) 1 5 16 17 18 19 20 32 33 34 35 36 37 40 101 105 120 132 133 134 135 136 137 140 ^SSTGI Used as applicable Next Action Indicator X X X X X X X X X X X X X X Command Name Proactive Commands (TA ← ME ← SIM) Follows GSM 11.14 (ver 8.5.0 2000-12) Section 13.4 X REFRESH X SET UP EVENT LIST X X SET UP CALL X X SEND SS X X SEND USSD X X SEND SHORT MESSAGE X SEND DTMF X X PLAY TONE X X DISPLAY TEXT X X GET INKEY X X GET INPUT X X SELECT ITEM X X SET UP MENU X X SET UP IDLE MODE TEXT Termination of Proactive Commands (URCs, TA ← ME ← SIM) Terminate REFRESH Terminate SET UP EVENT LIST Terminate SEND DTMF Terminate PLAY TONE Terminate DISPLAY TEXT Terminate GET INKEY Terminate GET INPUT Terminate SELECT ITEM Terminate SET UP MENU Terminate SET UP IDLE MODE TEXT Event Commands (TA → ME → SIM) Follows GSM 11.14 (ver 8.5.0 2000-12) Sections 12.25 and 13.1. User Menu Item Selection Follows GSM 11.14 (ver 8.5.0 2000-12) Section 12.25. User activity Idle screen available Language selection 211 232 233 235 250 251 252 254 ^SSTR required X Additional Commands (URCs, TA ← ME ← SIM) Get icon data (if told to be available by ^SSTGI) X End of session (used for next action indication only) Notification: Update to application menu Notification: SIM Application returns to main menu Note: Use of icons is not supported. All icon related actions will respond with = 0 (no icon). MC35_SAT_01_v02.00 Page 9 of 65 11.01.2002 Remote-SAT User's Guide 1.1.5 Parameter Types Strings are passed as UCS2 characters, usage of the GSM alphabet is also possible. However, use of the GSM alphabet is not recommended since a SIM can contain text which then is not displayable (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. There are 2 and 4 octet versions available, of which only the 2octet variant is used, known as UCS2. The 65536 positions in the 2-octet form of UCS are divided into 256 rows, each with 256 cells. The first octet of a character representation gives the row number, the second the cell number. The first row, row 0, contains exactly the same characters as ISO/IEC 8859-1. The first 128 characters are thus the ASCII characters. The octet representing an ISO/IEC 8859-1 character is easily transformed to the representation in UCS, by putting a 0 octet in front of it. UCS includes the same control characters as ISO/IEC 8859 and these are also in row 0. e.g. ’ ’ specifies the character set. specifies the character. 1.1.6 States of Remote-SAT The communication with the SIM Application Toolkit is performed via the AT commands detailed in the following chapters. In general, the type of AT command that can (and should) be issued depends on the current state of the Remote-SAT interface. The current state of Remote-SAT is determined by 1. the application running on the SIM, 2. the application running on the TA (external controller), 3. the internal actions of the ME (especially SAT and Call Control). MC35_SAT_01_v02.00 Page 10 of 65 11.01.2002 Remote-SAT User's Guide 1.1.6.1 Remote-SAT State Transition Diagram POWER ON (Hardware Reset) RESET /0 Event : SIM sends first Proactive Command A OFF /1 "AT^SSTA=1,x" "OK" B "AT^SSTR= , ,... "OK" "^SSTN:254" (an optional URC, if SIM Application has returned to its main menu) F E IDLE /2 C WAIT /4 D MC35_SAT_01_v02.00 "AT^SSTR=<2xx>,..." "OK" SIM sends PAC ^SSTN: " (URC) PAC /3 "AT^SSTGI= " "^SSTGI: ,..." Output depends on PAC "OK" G Page 11 of 65 SIM terminates PAC "^SSTN: " (as URC) 11.01.2002 Remote-SAT User's Guide 1.1.6.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. So 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. Meaning of options in column “M/O/X”: M: The TA has to issue the AT command to get Remote-SAT service (mandatory). O: Issue of the AT command is optional. X: Issue of the AT command is not allowed at this time and will lead to an error message. State AT command RESET State after power on the ME and no notification given by the SIM that an application is (0) available. No write version of an AT command is allowed. State is entered after SIM removal again. Action M/O/X Description ^SSTA=1,n X ^SSTGI= X ^SSTR= X ^SSTR= X OFF SIM has released its application. (1) SAT service is available, but Remote-SAT interface needs to be activated by the TA. Action M/O/X Description ^SSTA=1,n M Enable SAT service, so that all SAT notifications may be issued as URCs (^SSTN: ). ^SSTGI= X ^SSTR= X ^SSTR= X IDLE SIM application is running, but no proactive command has been issued. (2) Action M/O/X Description ^SSTA=1,n O Use to switch to alphabet type ^SSTGI= X ^SSTR= X ^SSTR= O Response to indicate TA, i.e. user activity. PAC SIM application has issued a proactive command. This event is signaled to the TA via (3) ^SSTN: . Action M/O/X Description ^SSTA=1,n O Use to switch to alphabet type ^SSTGI= M Get information related to an issued notification ^SSTN: . This is requested before a response can be issued via ^SSTR= . ^SSTR= X ^SSTR= X WAIT SIM application is waiting for the response to the ongoing proactive command. (4) Action M/O/X Description ^SSTA=1,n O Use to switch to alphabet type ^SSTGI= X ^SSTR= M Issue Terminal Response related to the ongoing proactive command. ^SSTR= X MC35_SAT_01_v02.00 Page 12 of 65 11.01.2002 Remote-SAT User's Guide 1.1.7 Examples: Using Remote-SAT To give you an idea of how to start and use Remote-SAT, you may follow the steps described below: // Start after switch on the module at OK // Switch on verbose error messages at+cmee=2 OK // Enter the PIN code (if necessary due to SIM configuration) at+cpin=1234 OK // Ask if a SIM application is available and has started right now at^ssta? ^SSTA: 1,1,1,"7FFFFFFF7F0100DF1F" OK // OK, First ´1´ tells us that SIM application has started but interface is still in ´OFF´ state. // Tell the module that we are interested in SAT, i.e. switch to ´IDLE´ state. at^ssta=1,0 OK // Now we receive the first proactive command ^SSTN:37 // We have to ask for the parameter details at^sstgi=37 // These are the details: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: 37,0,3,"SAT Special Menue",0,1,1,0 37,1,"News",0,0 37,2,"EMail",0,0 37,3,"Banking",0,0 OK // We always have to acknowledge the proactive command at^sstr=37,0 OK // SAT tells us that the proactive session has ended and enters its main menue (which should then be opened on the sreen by an MMI): ^SSTN:254 // Now we want to select item no. 1 of the menue sent before: at^sstr=211,0,1 OK MC35_SAT_01_v02.00 Page 13 of 65 11.01.2002 Remote-SAT User's Guide // We get the next proactive command: ^SSTN:36 // We ask for more information... at^sstgi=36 // ... and get it: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: ^SSTGI: 36,0,12,"Rubriken >",0,0,1,1,0 36,1,"News >",0,0 36,2,"Stock Infos>",0,0 36,3,"Aktien D >",0,0 36,4,"Aktien INT >",0,0 36,5,"Sport >",0,0 36,6,"1.BL-Clubs >",0,0 36,7,"Unterhaltng>",0,0 36,8,"Horoskop >",0,0 36,9,"Wetter D >",0,0 36,10,"Wetter INT >",0,0 36,11,"Wetter spez>",0,0 36,63,"Extras >",0,0 OK // Do not forget to acknowledge: at^sstr=36,0,63 OK // And again: We get the next proactive command: ^SSTN:36 // ... MC35_SAT_01_v02.00 Page 14 of 65 11.01.2002 Remote-SAT User's Guide 1.1.8 Sequence scenarios In the following sequence diagrams dashed lines refer to events which respond to a formerly issued request. 1.1.8.1 Initialisation sequence TA: ME: SIM: Reset 0 Release Sim Application Off 1 ^SSTN: 255 AT^SSTA = 1,n Idle 2 OK The SAT starts in the “Reset” state when the module powers up. In this state no SAT related AT commands can be issued or responses received. When the SIM Application is released SAT moves into the “Off” state. When in the “Off” state a supported SIM Application exists on the SIM card. The TA receives an Unsolicited Result Code to indicate this and SAT can be activated now by activated by the TA. Issuing the AT^SSTA command activates SAT and specifies the alphabet to be used. SAT then moves into the “Idle” state where it is then ready for use. When in “Idle” state SAT can receive input from the TA, such as forms of the AT^SSTR command. MC35_SAT_01_v02.00 Page 15 of 65 11.01.2002 Remote-SAT User's Guide 1.1.8.2 Proactive Command sequence TA: ME: SIM: Idle 2 Issue PAC PAC 3 ^SSTN: AT^SSTGI: Wait 4 ^SSTGI: ,..values.. AT^SSTR: TERMINAL RESPONSE: Idle 2 OK ^SSTN: 254 Upon receiving a Proactive command (PAC) from the SIM, SAT steps into the “PAC” state. The TA is informed that a PAC has been issued and is expected to respond with a request for further information. Whilst in the “PAC” state some forms of the AT^SSTR commands can be issued. Upon receiving the AT^SSTGI command SAT changes into the “Wait” state. Further information about the PAC is sent to the TA and a response is required to trigger a TERMINAL RESPONSE back to the SIM Application. SAT then moves back to the “Idle” state and either another PAC is issued or SAT informs the TA that the proactive session is over. MC35_SAT_01_v02.00 Page 16 of 65 11.01.2002 Remote-SAT User's Guide 1.1.8.3 Envelope Command sequence (Menu Selection) TA: ME: SIM: Idle 2 AT^SSTR: ENVELOPE CMD OK Idle 2 A SIM Application will provide SAT with Main Menu to display, using the PAC SETUP MENU. The Envelope Command MENU SELECTION allows the TA to select an item from this menu, via AT^SSTR. When this takes place, SAT will issue a response to the user, but will not change the state. The SIM Application is then generally expected to issue a PAC. MC35_SAT_01_v02.00 Page 17 of 65 11.01.2002 Remote-SAT User's Guide 1.1.8.4 Envelope Command sequence (Call / MO / SMS Control) TA: ME: SIM: Idle 2 ENVELOPE CMD RESPONSE PAC 3 ^SSTN: AT^SSTGI: Wait 4 ^SSTGI: ,..values.. AT^SSTR: Idle 2 OK Envelope commands are issued for Call/MO Control by 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. This sends SAT into the “Wait” state upon which is sends the relevant Call/MO Control information to the TA. SAT then returns to its “Idle” state. MC35_SAT_01_v02.00 Page 18 of 65 11.01.2002 Remote-SAT User's Guide 1.1.8.5 Event Download sequence TA: ME: SIM: Idle 2 AT^SSTR: ENVELOPE CMD OK Idle 2 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. MC35_SAT_01_v02.00 Page 19 of 65 11.01.2002 Remote-SAT User's Guide 1.2 AT^SSTA Remote-SAT Activation Test command Response AT^SSTA=? ^SSTA:(list of supported s), (list of supported s) Parameter description see below. Read command AT^SSTA? The read command can be used to request the current operating status and the used alphabet of the Remote-SAT interface. State handling is described in chapter “States of Remote-SAT”, pg. 10. Response ^SSTA: , , , device is in one of the following state: 0 RESET 1 OFF 2 IDLE *) 3 PAC 4 WAIT *) Note: Only this state can be selected directly by the TA, see write command. 0 SAT is already used on an other instance (logical channel in case of the multiplex protocol). Only test and read commands can be used. 1 SAT may be started on this instance via the write version of this command (see below). SAT profile according to GSM 11.14, see appendix. The profile tells the SIM application which features are supported by the SIM Application Toolkit implemented by the ME. The profile cannot be changed by the TA. Write command AT^SSTA= [, ] The write command activates the AT command interface to the SIM Application Toolkit in the ME. It must be issued each time the ME is switched on again. However, removing and inserting the SIM does not affect the activation status. SAT commands which are not using the AT interface (non MMI related SAT commands , e.g. PROVIDE LOCAL INFORMATION) may be executed without activating Remote-SAT. Response OK MC35_SAT_01_v02.00 Page 20 of 65 11.01.2002 Remote-SAT User's Guide Parameter 1 Activate Remote-SAT (to enter state IDLE) 0 GSM default alphabet (GSM 03.38)Input of a character requests one byte , e.g. “Y”. • On ME´s output of string parameter (e.g. ,”Examples”) character values will range from 32 to 255. • On input to the ME only character values from 32 to 128 are accepted! Therefore input characters with GSM alphabet values outside this range have to be entered with an escape character and the hexadecimal value, e.g. “\00 is @”. 1 UCS2 To display the 16 bit value of characters represented in UCS2 alphabet a 4 byte string is required, e.g. “0059” is coding the character “Y”. For details please refer to ISO/IEC 10646. Reference Note Siemens Use of GSM default alphabet may cause software flow control (XON/XOFF) problems. MC35_SAT_01_v02.00 Page 21 of 65 11.01.2002 Remote-SAT User's Guide 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 then be used by the TA to request the parameters of the proactive command from the ME. Upon receiving the ^SSTGI response from the ME, the TA must send AT^SSTR to confirm the execution of the proactive command and provide any required user response e.g. selected menu item. Unsolicited result code ^SSTN: Parameters Proactive command ID, see Table 1 Note: Only one proactive command can be ongoing at any one time. Terminate Proactive Command When the SIM application has issued a proactive command, via the ME, to the TA, it is possible that this command must be terminated. The ^SSTN Unsolicited Result Code is sent but with a different command type (add terminate offset 100), to indicate the termination of the specified command. The state changes to idle. The TA should then avoid sending any further commands related to the terminated proactive command, e,g. AT^SSTGI or AT^SSTR. Unsolicited result code ^SSTN: Parameters is defined as + terminate offset. The terminate offset equals 100. Terminate proactive command ID, see Table 1 Command Type Identifiers SIM Application returns to main menu Notification to the TA when the SIM Application has finished a command cycle and again enters its main menue, which was transferred with an URC ^SSTN: 37 (SET UP MENU) at start up. This URC should be used to open this menue on the sreen. The TA does not need to respond directly, i.e. AT^SSTR is not required. Unsolicited result code ^SSTN: <254> Reference Note Siemens MC35_SAT_01_v02.00 Page 22 of 65 11.01.2002 Remote-SAT User's Guide 1.4 AT^SSTGI Remote-SAT Get Information 1.4.1 AT^SSTGI Remote-SAT Get Information – Generic Format Test command Response AT^SSTGI=? ^SSTGI:(list of supported s), (list of supported s) OK Read command Response AT^SSTGI? ^SSTGI: , OK Parameters Remote-SAT interface states (refer to AT^SSTA) Ongoing Proactive Command (values see chapter 1.1.4 “Command Type Values”). However, this information is valid during states PAC and WAIT only. Write command There are two situations for use of the Write command: AT^SSTGI= 1. Regularly the Write command is used upon receipt of an unsolicited result code ^SSTN: . In this case the TA is expected to acknowledge the ^SSTGI response with AT^SSTR to confirm that the proactive command has been executed. AT^SSTR will also provide any user information e.g. selected menu item. 2. There may be the situation to request the information via AT^SSTGI without previously receiving an URC ^SSTN: . This will always be the case if the TA has started or restarted its application (e.g. a MMI) after power on the ME. To request the information despite the probably missed URCs it is possible to issue AT^SSTGI during states IDLE, PAC and WAIT at any time for the following Proactive Commands: PAC type 5: Set Up Event List, PAC type 37: Setup Menu, PAC type 40: Setup Idle Mode Test. Note: In case of using the Write command without receipt of an unsolicited result code ^SSTN: it is neither necessary nor possible to acknowledge the ^SSTGI response with AT^SSTR. Such a ^SSTGI response will not cause any state changes. The command type value is returned to the ME to identify which ^SSTN is being responded to. Reference Note Siemens MC35_SAT_01_v02.00 Page 23 of 65 11.01.2002 Remote-SAT User's Guide 1.4.2 AT^SSTGI Remote-SAT Get Information – Refresh (1) Write command This command is to be used upon receiving an unsolicited result code AT^SSTGI=1 ^SSTN:1. The response from the module indicates the type of REFRESH that is going to be undertaken. Response ^SSTGI: , Parameters 1 – Proactive command ID, see Table 1 Unsigned Integer, range 0 – 255, used as an enumeration. 0 SIM Initialization and Full File Change Notification; 1 File Change Notification; 2 SIM Initialization and File Change Notification; 3 SIM Initialization; 4 SIM Reset; ME is performing a SIM reset. Therefore a Terminal Response should not be issued. 5 to 255 = reserved values. For every return value of except 4 (SIM reset) the external application shall react as follows: 1. Issue the related Terminal Response AT^SSTR=1, . 2. If is 0 (Command performed successfully) the TA is requested to show a “Please wait” alert window on its screen until it will receive the RSAT notification ^SSTN:101 (Terminate proactive command REFRESH). Reference Note Siemens MC35_SAT_01_v02.00 Page 24 of 65 11.01.2002 Remote-SAT User's Guide 1.4.3 AT^SSTGI Remote-SAT Get Information – Set Up Event List (5) Write command AT^SSTGI=5 This command is mainly to be used upon receiving an unsolicited result code ^SSTN:5. However, please refer to note below. The response informs the TA of the events that it must monitor within itself. If any of these events then occur the TA must report them to the ME. Response ^SSTGI: , , Parameters 5 – Proactive command ID, see Table 1 This byte is RFU. Unsigned integer, used as bitfield: bit 1-4 RFU bit 5 bit 6 0 User Activity not in Event List 1 Any user activity (keyboard press) has to be signaled to the ME. 0 Idle Screen Available not in Event List 1 Any idle screen available event has to be signaled to the ME. bit 7 bit 8 bit 9 – 16 RFU 0 Language Selection not in Event List 1 Language Selection events have to be signaled to the ME. RFU The event list tells the TA which events have to be reported to the ME via the related commands AT^SSTR=(232, 233, 235). Reference Note Siemens It is possible to issue AT^SSTGI during states IDLE, PAC and WAIT for this Proactive Command without previously receiving an URC ^SSTN: , see section “AT^SSTGI Remote-SAT Get Information – Generic Format”, pg. 23. MC35_SAT_01_v02.00 Page 25 of 65 11.01.2002 Remote-SAT User's Guide 1.4.4 AT^SSTGI Remote-SAT Get Information – Setup 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 ask for the command parameter via AT^SSTGI=16. 2. If the SIM Application supplies no confirmation text or icon parameter, the TA gives other information to the user, e.g. the telephone number. In this case flow continues at 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 confirmation phase the TA may present a dialling animation on the screen until a mandatory parameter line ^SSTR: 16, , is issued. 7. If is not equal to 0 the dialling process did not perform successfully. If 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 regarding the dial termination cause, e.g. call barring through Call Control by SIM mechanism. is an empty string, the TA shall give an own indication to the user. 8. If is equal to 0, the dial process has been successfully finished: If is not an empty string, this text shall be used to inform the user during the call setup. If is an empty string, and/or shall be used to inform the user during call setup. However, if 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: , , , , , , , , Parameters 16 – Proactive command ID, see Table 1 This byte is RFU. String for user confirmation stage String containing called number String for call setup stage Unsigned Integer, range 0 – 255, used as a bitfield. bit 1: 0 = icon is self explanatory and replaces text MC35_SAT_01_v02.00 Page 26 of 65 11.01.2002 Remote-SAT User's Guide 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-8: = RFU 0-255, 0: no icon 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-8: = RFU 0-255, 0: no icon Reference Siemens Note MC35_SAT_01_v02.00 Page 27 of 65 11.01.2002 Remote-SAT User's Guide 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. Response ^SSTGI: , [ ], [ ], , , , Parameters Reference 17 – Proactive command ID, see Table 1 This byte is RFU. String 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-8: = RFU 0-255, 0: no icon Note Siemens MC35_SAT_01_v02.00 Page 28 of 65 11.01.2002 Remote-SAT User's Guide 1.4.6 AT^SSTGI Remote-SAT Get Information – Send USSD (18) Write command AT^SSTGI=18 This command is to be used upon receiving an unsolicited result code ^SSTN:18. The module is sending an unstructured 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. Response ^SSTGI: , [ ], [ ], , Parameters 18 – Proactive command ID, see Table 1 This byte is RFU. String 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-8: Reference = RFU 0-255, 0: no icon Note Siemens MC35_SAT_01_v02.00 Page 29 of 65 11.01.2002 Remote-SAT User's Guide 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. Response ^SSTGI: , , , , Parameters 19 – Proactive command ID, see Table 1 This byte is RFU. String to provide the user with information. If the string is provided by the SIM and is not a null data object (empty string), the TA shall use it to inform the user. This is also an indication that the TA should not give any other information to the user on the fact that the ME is sending a short message. If the string is a null data object (i.e. an empty string), the TA may give own information to the user concerning what is happening (e.g. “Please Wait”). 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-8: Reference = RFU Unsigned Integer, range 0-255, 0: no icon 1: an icon is provided by the SIM, the icon indicated in the command may be used by the ME to inform the user, in addition to, or instead of the alpha identifier, as indicated with the icon qualifier. Note Siemens MC35_SAT_01_v02.00 Page 30 of 65 11.01.2002 Remote-SAT User's Guide 1.4.8 AT^SSTGI Remote-SAT Get Information – Send DTMF (20) Write command AT^SSTGI=20 This command is to be used upon receiving an unsolicited result code ^SSTN:20. The SIM Application is sending DTMF tones to the network, and can provide the TA with some information about this. Text and an Icon Identifier can be passed to the TA to display to the user. Response ^SSTGI: , , , , Parameters Reference 20 – Proactive command ID see Table 1 This byte is RFU. String to provide user with information. 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-8: = RFU 0-255, 0: no icon Note Siemens MC35_SAT_01_v02.00 Page 31 of 65 11.01.2002 Remote-SAT User's Guide 1.4.9 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. Response ^SSTGI: , , >, , , , , Parameters 32 – Proactive command ID, see Table 1. This byte is RFU. String to accompany tone Tone that the ME generates Standard supervisory tones: 01 Dial tone 02 Called subscriber busy 03 Congestion 04 Radio path acknowledge 05 Radio path not available / Call dropped 06 Error / Special information 07 Call waiting tone 08 Ringing tone ME proprietary tones: 10 General beep 11 Positive acknowledgement tone 12 Negative acknowledgement or error tone 0 Minutes 1 Seconds 2 Tenths of Seconds bit 1: 0 1 bits 2-8: Duration of tone, expressed in units (1-255) Unsigned Integer, range 0 – 255, used as a bitfield. icon is self explanatory and replaces text 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). RFU 0-255, 0: no icon Reference Note Siemens Command is issued if the SIM application requests playing a tone with a length more than 5 seconds. MC35_SAT_01_v02.00 Page 32 of 65 11.01.2002 Remote-SAT User's Guide 1.4.10 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 display to the user. Response ^SSTGI: , , , , , Parameters 33 – Proactive command ID, see Table 1 Unsigned Integer, range 0 – 255, used as a bitfield. bit 1: 0 = normal priority 1 = high priority bits 2-7: = RFU bit 8: 0 = clear message after a delay 1 = wait for user to clear message String to be displayed (up to 240 bytes) Indicates when to send TERMINAL RESPONSE 0 = send TERMINAL RESPONSE when text clears from screen 1 = TERMINAL RESPONSE sent immediately 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-8: = RFU 0-255, 0: no icon Reference Note Siemens MC35_SAT_01_v02.00 Page 33 of 65 11.01.2002 Remote-SAT User's Guide 1.4.11 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. Response ^SSTGI: , , , , Parameters Reference 34 – Proactive command ID, see Table 1 Unsigned Integer, range 0 – 255, used as a bitfield. bit 1: 0 = digits (0-9, *, # and +) only 1 = alphabet set; bit 2: 0 = SMS default alphabet (GSM character set) 1 = UCS2 alphabet bit 3: 0 = character sets defined by bit 1 and bit 2 are enabled 1 = character sets defined by bit 1 and bit 2 are disabled and the "Yes/No" response is requested bits 4-7: = RFU bit 8: 0 = no help information available 1 = help information available String as prompt for text. 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-8: = RFU 0-255, 0: no icon Note Siemens MC35_SAT_01_v02.00 Page 34 of 65 11.01.2002 Remote-SAT User's Guide 1.4.12 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 display to the user. Response ^SSTGI: , , , , , [ ], , Parameters 35 – Proactive command ID, see Table 1 Unsigned Integer, range 0 – 255, used as a bitfield. bit 1: 0 = digits (0-9, *, #, and +) only 1 = alphabet set bit 2: 0 = SMS default alphabet (GSM character set) 1 = UCS2 alphabet bit 3: 0 = ME may echo user input on the display 1 = user input shall not be revealed in any way (see note) bit 4: 0 = user input to be in unpacked format 1 = user input to be in SMS packed format bits 5 to 7: RFU bit 8: 0 = no help information available 1 = help information available String as prompt for text minimum length of user input (0 – 255) maximum length of user input (0 – 255) String supplied as default response text 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-8: = RFU 0-255, 0: no icon Reference Note Siemens Hidden entry mode (GSM 11.14) is only available when using digit input. In hidden entry mode only characters ‘0’-‘9’, ‘*’ and ‘#‘ are allowed. MC35_SAT_01_v02.00 Page 35 of 65 11.01.2002 Remote-SAT User's Guide 1.4.13 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. In addition to text strings and icon identifiers, a next action indicator informs the user of the likely result of selecting a chosen item. Response The first line of output from the ME is: ^SSTGI: , ,