User`s guide

Chapter 1 – AT Commands for Remote SIM Application Toolkit

Multi-Tech Systems, Inc. SIM Application Toolkit AT Commands (S000391C) 25

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.

Response

^SSTGI: <cmdType>, <commandDetails>, <text>, <immediateResponse>,

Parameters

<cmdType> 33 – Proactive command ID. See Table 1.

<commandDetails> Unsigned Integer, range 0 – 255, used as a bitfield.

bit 1: 0 = Normal priority (see note).

1 = High priority (see note).

bits 2 to 7: = RFU.

bit 8: 0 = Clear message after a delay.

1 = Wait for user to clear message.

<text> String to be displayed (up to 240 bytes).

<immediateResponse> Indicates when to send TERMINAL RESPONSE.

0 = Send TERMINAL RESPONSE when text clears from

screen.

1 = TERMINAL RESPONSE sent immediately.

<iconQualifier> 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.

<iconId> 0-255, 0: No icon.

Note:

The MMI shall reject normal priority text commands if the screen is currently used for

more than its normal standby display; e.g., the MMI is in sub-menu. If the command

is rejected, the MMI sends the TERMINAL RESPONSE message to the SIM (ME

currently unable to process command – screen busy).

High priority text shall be displayed on the screen immediately, except if a priority

conflict of the alerting events occurs; e.g., incoming call or a URC if the battery needs

to be charged. See GSM 11.14, Chapter “Proactive SIM commands and procedures,

Display Text”.