GetUSSDPush

From IRON Test Suite
Jump to navigation Jump to search

DESCRIPTION

This command gets USSD data pushed by Network to the specified GSM port. Optional flag can be specified to remove this received data from port internal buffer. Response text is displayed as GSM7 or UCS2 coded string. In the case of UCS2 coding each character is displayed as 2 hexadecimal digits.

COMMAND

Command Input arguments Returns
GetUSSDPush Port index, [ResetFlag] USSD data string

OUTPUT

USSD data sent by Network

EXAMPLE

~# GetUSSDPush 0
GSM7:New credit available.

~# GetUSSDPush 0
UCS2:004E006F0075007600650061007500200063007200E900640069007400200064 006900730070006F006E00690062006C0065

API

MessageCode: GRA_GET_USSD_PUSH_REQUEST

MESSAGE BODY
Field Name Length Description
PortIndex 4 GSM Port index
ResetFlag 4 Reset flag

The format of Message Body can be coded as the following C-language structure:

typedef struct
{
   ULONG    PortIndex;
   ULONG    ResetFlag;
} GRAM_GET_USSD_PUSH_REQUEST;

MessageCode: GRA_GET_USSD_PUSH_CONFIRM

MESSAGE BODY
Field Name Length Description
Status 4 Command status:
0- Successful
1- Error - No existing USSD session
2- Error - Command failed
USSDPush 512 USSD Push data string
CharSet 4 Character set used (set in AT+CSCS):

0- Unknown
1- GSM
2- HEX
3- UCS2

The format of Message Body can be coded as the following C-language structure:

typedef struct 
{
   ULONG    Status;
   UCHAR    UssdPush[512];
   ULONG    CharSet;
} GRAM_GET_USSD_PUSH_CONFIRM;