Siemens TC65 Terminal. Manual (Version: 02.000)

9.8 AT+CHLD

Notes

• The AT+CHLD command offers a broad range of options according to the GSM specifications. However, if you

attempt to invoke an option which is not provisioned by the network, or not subscribed to, invocation of this

option will fail. The responses in these cases may vary with the network (for example "Operation not allowed",

"Operation not supported" etc.).

• The handling of the supplementary service Call hold and Multiparty varies with the types of calls. This is

because only voice calls can be put on hold, while data or fax calls cannot. The following procedures apply:

With AT+CHLD=2 the user can simultaneously place a voice call on hold and accept another waiting voice,

data or fax call. If the waiting call is a data or fax call, it is also possible to put the voice call on hold. To switch

back from the active data or fax call to the held voice call the active call must be terminated with AT+CHLD=1.

If all active and held calls are voice calls it is possible to switch back and forth with AT+CHLD=2.

• In conflict situations, e.g. when a waiting call comes while there are already held calls, the above procedures

apply to the waiting call only. For example, <n>=0 rejects the waiting call, but does not affect the held calls.

• See also the AT+CCWA command for details on how to display waiting calls.

Example

^SYSSTART

at+cpin="9999"

+CREG: 2

+CREG: 1,"0145","0016"

The mobile is now registered.

at+ccwa=1,1,1

You activate the indication of waiting calls during

voice calls.

atd"1234567";

You make a voice call.

+CCWA: "+491791292364",145,32,,0

You receive a URC indicating a waiting data call.

at+chld=2

You put the voice call on hold.

CONNECT 9600/RLP

The data connection is set up.

hello

+++

With ''+++'' you go in command mode.

at+clcc

You interrogate the status of all established calls.

+CLCC: 1,0,1,0,0,"03038639268",129

+CLCC: 2,1,0,1,0,"+491791292364",145

at+chld=1

The active data call is terminated and the held voice

call becomes active.

at+clcc

+CLCC: 1,0,0,0,0,"03038639268",129

Page 240 of 567

9.9 AT+CLIP

9.9

AT+CLIP Calling Line Identification Presentation

This command refers to the GSM supplementary service CLIP (Calling Line Identification Presentation) that

enables a called subscriber to get the calling line identity (CLI) of the calling party when receiving a mobile ter-

minated call.

The AT+CLIP write command enables or disables the presentation of the CLI at the TE. It has no effect on the

execution of the supplementary service CLIP in the network.

The AT+CLIP read command gives the status of <n>, and also triggers an interrogation of the provision status

of the CLIP service according to GSM 02.81 (given in <m>). If no SIM card is available or the SIM-PIN is not

entered, the command response is "ERROR".

Syntax

Test Command

AT+CLIP=?

Response(s)

+CLIP: (list of supported<n>s)

Read Command

AT+CLIP?

Response(s)

+CLIP: <n>, <m>

ERROR

+CME ERROR: <err>

Write Command

AT+CLIP=<n>

Response(s)

ERROR

+CME ERROR: <err>

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07, GSM 02.81

Unsolicited Result Code

+CLIP: <number>, <type>, , [, <alpha>][, <CLI validity>]

When CLIP is enabled at the TE (and is permitted by the calling subscriber), this URC is delivered after every

"RING" or "+CRING" URC when a mobile terminated call occurs.

Parameter Description

<n>^{(num)(&W)(&V)}

[0]^(&F)

Suppress unsolicited result codes

Display unsolicited result codes

<m>^(num)(&V)

CLIP not provisioned

CLIP provisioned

Unknown

Page 241 of 567

9.9 AT+CLIP

<number>^(str)

String type phone number of calling address in format specified by <type>.

<type>^(num)

Type of address octet in integer format; 145 when dialing string includes international access code character

"+", otherwise 129.

<alpha>^(str)

String type alphanumeric representation of <number> corresponding to the entry found in phonebook; used

character set is the one selected with AT+CSCS.

<CLI validity>^(num)

CLI valid

CLI has been withheld by the originator.

CLI is not available due to interworking problems or limitations of originating

network. <number> shall be an empty string ("") and <type> value will not be

significant.

When CLI is not available ( <CLI validity>=2), <number> shall be an empty string ("") and <type> value

will not be significant. Nevertheless, TA shall return the recommended value 128 for <type> (TON/NPI

unknown in accordance with GSM 04.08 subclause 10.5.4.7).

When CLI has been withheld by the originator, (<CLI validity>=1) and the CLIP is provisioned with the

"override category" option (refer GSM 02.81 and GSM 03.81), <number> and <type> is provided. Otherwise,

TA shall return the same setting for <number> and <type> as if the CLI was not available.

Page 242 of 567

9.10 AT+CLIR

9.10

AT+CLIR Calling line identification restriction

The AT+CLIR command refers to the GSM supplementary service CLIR (Calling Line Identification Restriction).

Syntax

Test Command

AT+CLIR=?

Response(s)

+CLIR: (list of supported <n>s)

Read Command

AT+CLIR?

Response(s)

+CLIR<n>, <m>

ERROR

+CME ERROR: <err>

Write Command

AT+CLIR=[<n>]

Response(s)

ERROR

+CME ERROR: <err>

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Parameter Description

<n>^(num)

Parameter shows the settings for outgoing calls:

[0]^(P)

Presentation indicator is used according to the subscription of the CLIR service

CLIR invocation

CLIR suppression

<m>^(num)

Parameter shows the subscriber CLIR service status in the network:

CLIR not provisioned

CLIR provisioned in permanent mode

Unknown (e.g. no network, etc.)

CLIR temporary mode presentation restricted

CLIR temporary mode presentation allowed

Note

• The settings made with AT+CLIR=1 or AT+CLIR=2 are used for all outgoing calls until the ME is switched off

or AT+CLIR=0 is used.

Page 243 of 567

9.11 AT+COLP

9.11

AT+COLP Connected Line Identification Presentation

This command refers to the GSM supplementary service COLP (Connected Line Identification Presentation) that

enables a calling subscriber to get the connected line identity (COL) of the called party after setting up a mobile

originated call. The command enables or disables the presentation of the COL at the TE. It has no effect on the

execution of the supplementary service COLR in the network.

Syntax

Test Command

AT+COLP=?

Response(s)

+COLP:(list of supported <n>s)

Read Command

AT+COLP?

Response(s)

+COLP: <n>, <m>

ERROR

+CME ERROR: <err>

Write Command

AT+COLP=[<n>]

Response(s)

ERROR

+CME ERROR: <err>

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Unsolicited Result Code

Call response format:

+COLP: <number>, <type>

Parameter Description

<n>^(num)

Disable - suppress unsolicited result codes

Enable - display unsolicited result codes

<m>^(num)

COLP not provisioned (no presentation)

COLP provisioned

Unknown

<number>^(str)

String type phone number of connected address in format specified by <type>

Page 244 of 567

9.12 AT+CPUC

9.12

AT+CPUC Price per unit and currency table

Syntax

Test Command

AT+CPUC=?

Response(s)

Read Command

AT+CPUC?

Response(s)

+CPUC: <currency>, <ppu>

ERROR

+CME ERROR: <err>

Write Command

AT+CPUC=<currency>, <ppu>[, <passwd>]

Response(s)

ERROR

+CME ERROR: <err>

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Command Description

Read command returns the current parameters of PUC.

Write command sets the parameters of Advice of Charge related price per unit and currency table. SIM PIN2 is

usually required to set the parameters.

Parameter Description

<currency>^(str)(+CSCS)

Three-character currency code (e.g. "GBP", "EUR"). If the currency name is longer than three characters, all

characters will be cut off after the third position. Before they are written to the SIM Card, these characters are

converted to the standard GSM alphabet.

<ppu>^(str)

Price per unit; dot is used as a decimal separator (e.g. "2.66"). The length is limited to 20 characters. If the string

length is exceeded, the command is terminated with an error. This string may only contain digits and a dot. Lead-

ing zeros are removed from the string. The minimum and maximum value are determined by the structure of the

SIM-PUCT file. The maximum price per unit value is 999 999 999.00. When successfully entered, this value is

rounded to maximum accuracy.

Note: Due to storage in mantisse (range 0-4095) and exponent (-7 to 7) it is possible that rounding errors occur.

<passwd>^(str)

SIM PIN2. String parameter which can contain any combination of characters. The maximum string length is

limited to 8 characters. If this value is exceeded, the command terminates with an error message. If the PIN2 is

incorrect, a CME error (+CME ERROR: incorrect password) is output.

Page 246 of 567

9.13 AT+CSSN

9.13

AT+CSSN Supplementary service notifications

Syntax

Test Command

AT+CSSN=?

Response(s)

+CSSN: (list of supported<n>s), (list of supported<m>s)

Read Command

AT+CSSN?

Response(s)

+CSSN: <n>, <m>

Write Command

AT+CSSN=<n>[, <m>]

Response(s)

ERROR

+CME ERROR

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Unsolicited Result Codes

URC 1

+CSSI: <code 1>

When <n>=1 and a supplementary service notification is received after a mobile originated call setup, inter-

mediate result code "+CSSI: <code 1>" is sent to TE before any other MO call setup result codes

URC 2

+CSSU: <code 2>

When <m>=1 and a supplementary service notification is received during a mobile terminated call setup or

during a call, unsolicited result code "+CSSU: <code

2>" is sent to TE.

Command Description

The write command enables or disables the presentation of URCs for supplementary services.

Parameter Description

<n>^(num)

0^(&F)

Suppress "+CSSI" URCs

Activate "+CSSI" URCs

<m>^(num)

0^(&F)

Suppress "+CSSU" URCs

Activate "+CSSU" URCs

Page 248 of 567

9.14 AT+CUSD

9.14

AT+CUSD Supplementary service notifications

AT+CUSD allows control of the Unstructured Supplementary Service Data (USSD) according to GSM 02.90. Both

network and mobile initiated operations are supported. The interaction of this command with other commands

based on other GSM supplementary services is described in the GSM standard.

Parameter <n> is used to disable/enable the presentation of an unsolicited result code (USSD response from

the network, or network initiated operation) "+CUSD: <m>[<str_urc>[<dcs>]]" to the TE.

When parameter <str_write> is given, a mobile initiated USSD string or a response USSD string to a network

initiated operation is sent to the network. The response USSD string from the network is returned in a subsequent

unsolicited result code "+CUSD"

Syntax

Test Command

AT+CUSD=?

Response(s)

+CUSD: (list of supported<n>s)

Read Command

AT+CUSD?

Response(s)

+CUSD: <n>

Write Command

AT+CUSD=<n>[, <str_write>[, <dcs>]]

Response(s)

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

GSM 07.07, GSM 02.90, GSM 03.90,

GSM 04.90

Unsolicited Result Code

+CUSD: <m>[<str_urc>[<dcs>]]

URC "+CUSD" indicates an USSD response from the network, or network initiated operation

Parameter Description

<n>^(num)

0^(&F)

Disable the result code presentation in the TA

Enable the result code presentation in the TA

Cancel session (not applicable to read command response)

<str_write>^(str)

String type USSD-string (when <str_write> parameter is not given, network is not interrogated).

For the write command, only <dcs>= 15 is supported.

Page 250 of 567

9.14 AT+CUSD

<str_urc>^(str)(+CSCS)

String type USSD-string .

If <dcs> indicates that GSM 03.38 default alphabet is used TA converts GSM alphabet into current TE character

set according to rules of GSM 07.05 Annex A. Otherwise in case of invalid or omitted <dcs> conversion of

<str_urc> is not possible.

<dcs>^(num)

GSM 03.38 Cell Broadcast Data Coding Scheme in integer format (default 15). In case of an invalid or omitted

<dcs> from the network side (MT) <dcs> will not be given out.

<m>^(num)

No further user action required (network initiated USSD-Notify, or no further

information needed after mobile initiated operation)

Further user action required (network initiated USSD-Request, or further infor-

mation needed after mobile initiated operation).

<m>=1, then the URC ends with ">" to prompt the user for input. The user

action is finished with <CTRL-Z> or aborted with <ESC>.

USSD terminated by network.

operation not supported

network time out

Notes

• When a USSD string is sent via ATD, a "AT+CUSD=1" is executed implicitly.

• It is recommended to finalize or escape a pending USSD user interaction before further actions are done to

prevent blocking situations.

Page 251 of 567

10. Internet Service Commands

10.

Internet Service Commands

TC65 has an embedded TCP/IP stack that is driven by AT commands and enables the host application to easily

access the Internet. The advantage of this solution is that it eliminates the need for the application manufacturer

to implement own TCP/IP and PPP stacks, thus minimizing cost and time to integrate Internet connectivity into

a new or existing host application. This chapter is a reference guide to all the AT commands and responses

defined for use with the TCP/IP stack.

Access is provided to the following Internet Services:

1. Socket Client and Server for TCP, Client for UDP

2. FTP Client

3. HTTP Client

4. SMTP Client

5. POP3 Client

Two design strategies for using Internet Service AT commands - URC mode or polling mode:

The TC65 offers two modes of controlling an Internet session opened with AT^SISO. To select the mode that

best suits the preferences of your application design use the AT^SCFG command, parameter "Tcp/WithURCs"

(refer to <tcpWithUrc>).

• URC mode (delivery default):

The progress of an Internet session is URC driven. The URCs notify the host whether data can be sent or

received, whether data transfer has completed, whether the service can be closed or whether an error has

occurred. This mechanism eliminates the need to poll the service until the necessary progress information is

received.

To enable the URC mode select: AT^SCFG="Tcp/WithURCs",on.

• Polling mode:

In polling mode, the presentation of URCs related to the Internet Services is disabled. The host is responsible

to retrieve all the status information needed for controlling the Internet session. This is done by polling, where

the host application keeps sending the commands AT^SISR, AT^SISW, AT^SISI.

To enable the polling mode select: AT^SCFG="Tcp/WithURCs",off.

The disabled URCs are the following: "^SISR" URC, "^SISW" URC and "^SIS" URC for parameter <urc-

Cause>=0 (Internet service events), but not for <urcCause>=1 or 2 (needed for Socket listener and always

enabled).

Step-by-step overview of how to configure and use TCP/IP communications with TC65:

• Select URC mode or polling mode as described above.

• First of all, create a CSD or GPRS connection profile with AT^SICS. The connection profile is a set of basic

parameters which determines the type of connection to use for an Internet service. The connection type is

also referred to as bearer. Up to 6 connection profiles can be defined, each identified by the <conPro-

fileId>.

• Secondly, use AT^SISS to create a service profile based on one of the connection profiles. Up to 10 service

profiles can be defined, each identified by the <srvProfileId>. The service profile specifies the type of

Internet service to use, i.e. Socket, FTP, HTTP, or one of the email services SMTP or POP3. To assign a

connection profile to a service profile, the <conProfileId> of AT^SICS must be entered as "conId" value

of the AT^SISS parameter <srvParmTag>.

This offers great flexibility to combine connection profiles and service profiles. For example, you may have

one connection profile (CSD or GPRS) specified with AT^SICS which can be associated with an SMTP ser-

vice profile for sending emails and a POP3 service profile for retrieving emails.

• Once the connection profile and the service profile are created, an Internet session can be opened by entering

the AT^SISO write command and the desired <srvProfileId>.

In URC mode, the "^SISR" or "^SISW" URC indicates whether the service is ready to receive or send data.

This means, that the AT^SISR or AT^SISW command shall be entered after the URC was received. If an error

occurs the "^SIS" URC is delivered instead.

In polling mode, you can enter the AT^SISR or AT^SISW command straight after AT^SISO though you may

Page 252 of 567

need to do so several times until the service confirms that data can be sent or received.

• The first parameter of the AT^SISR or AT^SISW commands is always the <srvProfileId>, the second

parameter is the number of bytes which the host either wants to send to or is able to receive from the module.

The way the module handles the data transfer follows the rules of the ordinary socket interface and is aware

that a host may be limited by its input buffer size. The maximum data size supported by TC65 is 1500 bytes

in both directions (read or write). To send or receive more than 1500 bytes, the read or write action shall be

repeated until the data transfer has completed. Each read or write action requires that the command response

(of AT^SISR or AT^SISW) confirms that the service is ready to send or receive data.

To end an upload data stream set the <eodFlag> in the last AT^SISW command.

• The AT^SISI command shall be used to monitor the progress of the session. The command reports the ser-

vice state of the used service profile and indicates the number of bytes received, the number of bytes sent

and, in the case of sending, the number of bytes acknowledged or unacknowledged at TCP layer.

• If an error occurs during a session you can enter the AT^SISE command and the <srvProfileId> to iden-

tify the reason. This is especially important in polling mode.

• Finally, to end a session, enter the AT^SISC write command and the <srvProfileId>.

Additional AT commands designed for controlling and monitoring the connection profiles (bearers):

• The AT^SICI command can be used any time to query the current status of one or all connection profile(s).

• The AT^SICO command opens a connection and keeps it open until closed with AT^SICC or disconnected

by the network.

• The AT^SICC command closes a connection set up with AT^SICO.

• The AT^SISX command sends ICMP (Interntet Control Message Protocol) Echo Requests to a target IP

address or host name to verify the TCP/IP network connection.

Maximum number of profiles defined / used:

• Up to 6 connection profiles can be created (with AT^SICS).

• Up to 10 service profiles can be created (with AT^SISS), but the number of parallel profiles of the same ser-

vice type is limited as listed below. If the maximum number of a service profile type is already defined, any

attempt to set up another profile for the same type will be denied with "+CME ERROR: operation of service

temporary not allowed".

- Maximum 3 HTTP profiles

- Maximum 6 socket profiles: Only 2 instances can be opened for listener, meaning that if 2 listeners are

established another 4 instances can be opened for clients. Also, the socket service can accept an incom-

ing connection only when at least one service profile is still free (not yet created with AT^SISS), otherwise

the incoming connection will be rejected from the listener. If there is no listener established all 6 socket

profiles can be configured as client.

1 FTP profile

1 POP3 profile

1 SMTP profile

• The TCP/IP stack of TC65 supports using several service profiles at the same time, provided all of them are

running on the same connection profile. For example, it is possible to download files from an FTP server, while

sending and receiving emails at the same time.

Using Internet Service AT commands on several interfaces (ASC0, ASC1, USBor Multiplex mode on ASC0):

• A connection profile can be created on one interface and then viewed or changed on all other interfaces.

• A service profile can be used only on one interface at a time:

- Service profiles can only be opened on the interface where they have been defined with AT^SISS.

- Accordingly, on each interface the read commands AT^SISO? and AT^SISI? deliver full status informa-

tion for the service profiles configured / opened on this interface, while service profiles related to other

interfaces are only listed by <srvProfileId> and service type name (= <srvParmTag> value "srv-

Type") without any status parameters.

- Changes to a service profile are allowed only on the same interface where it was created, trying to change

Page 253 of 567

it on another interface is denied with "+CME ERROR: Invalid index". If queried with the read command

AT^SISS? the entire profile is returned on the interface where the service profile was created, while on all

other interfaces only the service type of the profile is stated.

- To free a service profile for use on another interface, use the AT^SISS command and select service type

= "none". This action deletes the entire profile and restores all parameters of the profile to their initial

power-up state (all values are empty). For example, to remove the service profile 3, set AT^SISS=3,srv-

Type,none. After this, a new profile 3 can be created on any other interface.

Address notation

Server addresses must be provided as IP addresses in standard dot-format (e.g. "192.168.1.2") or as server

address names resolvable by a DNS server (e.g. "smtp.myserver.de" or "pop3.myserver.de").

Timeouts

Timeouts are not part of the Internet AT command functionality implemented in TC65 and, if desired, are the

responsibility of the host application. It is recommended that the host application validates URCs and AT com-

mand responses and reacts adequately, for example by sending a close message or starting a timer.

Socket service used with UDP protocol

The significant differences between the TCP and UDP protocols imply that UDP sometimes requires particular

procedures or even specific parameters. Details on how to handle UDP services can be found in extra notes or

are included in the general parameter descriptions.

The TC65 offers two kinds of Socket service with UDP protocol. One is referred to as UDP client intended for

connections to a given remote host. In this case the IP address and the UDP port of the remote host are set as

a fixed parameter in the service profile. The other type is referred to as UDP endpoint where IP address and UDP

port of the remote hosts are handled in each read (AT^SISR) and write (AT^SISW) request. This enables the

host application to communicate with different remote hosts.

Using the DCD line to detect the connection status of Internet services

With AT&C you can configure the DCD line of the used serial interface to indicate whether an Internet service is

active. For Socket, HTTP, SMTP and POP3 the states "Up" or "Connecting" are indicated, for FTP only the state

"Up".

Page 254 of 567

10.1 AT^SICS

10.1

AT^SICS Internet Connection Setup Profile

AT^SICS serves to create and edit Internet connection profiles. A connection profile can be assigned to one or

more service profiles defined with AT^SISS, and thus, determines which type of connection is to be established

when opening a service profile with AT^SISO.

The AT^SICS read command requests the current settings of all Internet connection profiles. One line is issued

for every possible parameter of a given <conParmTag> "conType" value.

The AT^SICS write command specifies all parameters of a connection profile identified by <conProfileId>.

At first the type of Internet connection needs to be selected via <conParmTag> value "conType". This deter-

mines the applicability of all other <conParmTag> values related to this "conType" and automatically sets their

defaults. An exception is the <conParmValue-alphabet> which can be set before or after selecting "con-

Type".

To change the settings the write command needs to be executed for each single <conParmTag>. All profile

parameters set with AT^SICS are volatile.

Table 10.1: Applicability of AT^SICS <conParmTag> values

<conParmTag> value

CSD

GPRS0

"conType"

mandatory

"user"

optional

"passwd"

optional

"apn"

mandatory

"inactTO"

optional

"calledNum"

mandatory

"dataRate"

mandatory

"dataType"

mandatory

"authMode"

mandatory

optional

"fnur"

optional

"dns1"

optional

"dns2"

optional

"alphabet"

optional

Syntax

Test Command

AT^SICS=?

Response(s)

Read Command

AT^SICS?

Response(s)

^SICS: <conProfileId>, <conParmTag>, <conParmValue>

Page 255 of 567

10.1 AT^SICS

Write Command

AT^SICS=<conProfileId>, <conParmTag>, <conParmValue>

Response(s)

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

Parameter Description

<conProfileId>^(num)

0...5

Internet connection profile identifier.

The <conProfileId> identifies all parameters of a connection profile, and,

when a service profile is created with AT^SISS the <conProfileId> needs

to be set as "conId" value of the AT^SISS parameter <srvParmTag>.

<conParmTag>^(str)

Internet connection parameter.

"conType"

Type of Internet connection.

For supported values of <conParmValue> refer to <conParmValue-con-

Type>.

"alphabet"

Selects the character set for input and output of string parameters within a pro-

file.

The selected value is bound to the specific profile. This means that different

profiles may use different alphabets. Unlike other parameters the alphabet can

be changed no matter whether the <conParmTag> value "conType" has been

set.

For supported values of

<conParmValue> refer to

<conParmValue-

alphabet>.

"user"

User name string: maximum 32 characters (where "" is default).

"passwd"

Password string: maximum 32 characters (where ***** is default).

If <conParmValue-authMode> is "MsChapV1" then the maximum password

length is 16 characters.

"apn"

Access point name string value: maximum 100 characters (where "" is default).

"inactTO"

Inactivity timeout value in seconds: 0 ... 2¹⁶-1, default = 20

Number of seconds the bearer remains open although the service no longer

needs the bearer connection.

Do not set the timeout value below 3 sec. This may result in problems when

using the <eodFlag> (set in the last AT^SISW command to terminate an

upload data stream).

The value -1 indicates that, after opening the bearer with AT^SICO, the inac-

tivity timeout is currently disabled. Closing the bearer with AT^SICC restores

the previously set "inactTO" value of the concerned connection profile.

"calledNum"

Called BCD number.

"dataRate"

Data rate.

For supported values of <conParmValue> refer to <conParmValue-dat-

aRate>.

"dataType"

Data call type.

For supported values of

<conParmValue> refer to

<conParmValue-

dataType>.

Page 256 of 567

10.1 AT^SICS

"authMode"

Authentication mode.

For supported values of <conParmValue> refer to <conParmValue-auth-

Mode>.

"fnur"

Fixed Network User Rate.

For supported values of <conParmValue> refer to <conParmValue-fnur>.

"dns1"

Primary DNS server address (IP address in dotted-four-byte format).

This value determines whether to use the DNS server addresses dynamically

assigned by the network or a specific DNS server address given by the user.

"dns1" = "0.0.0.0" (default) means that the CSD or GPRS connection profile

uses dynamic DNS assignment. Any other address means that the Primary

DNS is manually set.

The default value applies automatically if no other address is set. Note that the

AT^SICS read command only returns a manually configured IP address, while

the value "0.0.0.0" is not indicated at all, no matter whether assumed by default

or explicitly specified.

See also AT^SFNUR command.

not applicable

[1]

9.6 kbit/s

14.4 kbit/s

19.2 kbit/s

28.8 kbit/s

38.4 kbit/s

48.0 kbit/s

56.7 kbit/s

64.0 kbit/s

Notes

• Before opening a service profile based on a connection profile recently used, check with AT^SICI that the

previous connection was properly closed. If AT^SICI confirms that the connection profile is in <conState>

0 (Down) the connection profile may be used again.

• If a GPRS network does not support or is not correctly configured for automatic DNS address assignment the

TCP/IP stack cannot resolve fully qualified domain names. In this case, a warning message will be returned

when trying to open an Internet service configured for automatic DNS address assignment.

10.1.1

Example: Default values of a CSD connection profile

As stated earlier, the "conType" selected with AT^SICS determines all other matching profile parameters related

to this "conType". Once "conType" is set in a new profile, the default values of all other related parameters are

assumed. To view the default settings you can use the read command AT^SICS?.

at^sics=1,conType,CSD

Select connection type CSD, identified by <con-

ProfileId>1

at^sics?

Query current profiles.

Page 258 of 567

10.1 AT^SICS

^SICS: 0, "conType", ""

Profile with <conProfileId> 0 is still empty.

^SICS: 1, "conType", "CSD"

The new CSD profile just created is indicated with all

related parameters set to their default.

^SICS: 1, "alphabet", "0"

Character set determined with AT+CSCS applies

when string parameters are input with AT^SICS.

^SICS: 1, "user", ""

No user name set.

^SICS: 1, "passwd", "*****"

Password masked with asteriks.

^SICS: 1, "authMode", "PAP"

Authentication protocol PAP is assumed as default.

^SICS: 1, "inactTO", "0"

No inactivity timeout set.

^SICS: 1, "calledNum", ""

No destination set.

^SICS: 1, "dataRate", "1"

Data rate set to 9.6 kbaud.

^SICS: 1, "dataType", "1"

Remote device is analog, e.g. an analog modem.

^SICS: 2, "conType", ""

Profile with <conProfileId> 2 is still empty.

^SICS: 3, "conType", ""

Profile with <conProfileId> 3 is still empty.

^SICS: 4, "conType", ""

Profile with <conProfileId> 4 is still empty.

^SICS: 5, "conType", ""

Profile with <conProfileId> 5 is still empty.

10.1.2

Example: GPRS connection profile

at^sics=0,conType,GPRS0

Select connection type GPRS0.

AT^SICS=0,inactTO,"0"

Inactivitiy timeout = 0 (default).

AT^SICS=0,dns1,"193.254.160.1"

IP address of Primary DNS server.

AT^SICS=0,authMode,"PAP"

Authentication protocol PAP (default).

AT^SICS=0,passwd,t-d1

Password for GPRS services provided by the Ger-

man operator T-D1.

AT^SICS=0,apn,"internet.t-d1.de"

APN to access the GPRS services provided by the

German operator T-D1.

Page 259 of 567

10.2 AT^SICI

10.2

AT^SICI Internet Connection Information

The AT^SICI read command requests the current status of the Internet connection profiles currently defined

with AT^SICS.

The AT^SICI write command displays the status of the specified Internet connection profile. If the connection

profile is not defined yet, the command returns a "+CME ERROR" response.

Syntax

Test Command

AT^SICI=?

Response(s)

[^SICI:(list of defined <conProfileId>s)]

Read Command

AT^SICI?

Response(s)

[^SICI: <conProfileId>, <conState>, <numServices>, <conAddr>]

[^SICI: ...]

Write Command

AT^SICI=<conProfileId>

Response(s)

^SICI: <conProfileId>, <conState>, <numServices>, <conAddr>

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB MUX1

MUX2

MUX3

Charge

Last

Parameter Description

<conProfileId>^(num)

Internet connection profile identifier as defined by AT^SICS (<conProfileId>).

0...5

<conState>^(num)

State of the Internet connection profile.

Down - Internet connection is defined but not connected.

Connecting - A service has been opened and so the Internet connection is ini-

tated.

Up - Internet connection is established and usable by one or more services.

Limited Up - Internet connection is established, but temporarily no network cov-

erage.

Closing - Internet connection is terminating.

Page 260 of 567

10.2 AT^SICI

<numServices>^(num)

Number of services using this Internet connection profile.

0...9

<conAddr>^(str)

Local IP address of the Internet connection profile (empty if no address is associated yet).

Note

• Before opening a service profile based on a connection profile recently used, check with AT^SICI that the

previous connection was properly closed. If AT^SICI confirms that the connection profile is in <conState>

0 (Down) the connection profile may be used again.

10.2.1

Checking Connection Profile Status

at^sici?

Query the current status of the connection profile.

^SICI: 1,2,1,"10.10.0.161"

One connection profile has been created at <con-

ProfileId>=1, and one service is opened using

this connection profile. The Internet connection is in

<conState>=2 ("Up").

Assume the network connection is temporarily not available. (If URC presentation mode of network registration

is enabled the state is shown by the URC "+CREG: 2").

at^sici?

Query once again the current status of the connec-

tion profile.

^SICI: 1,3,1,"10.10.0.161"

Parameter <conState> has changed to state "Lim-

ited up".

The network connection is temporarily not available but the Internet connection is still established, so the host

may decide to stop the data transfer to minimize the risk of losing data due to memory limitations.

at^sici?

Query once again the current status of the connec-

tion profile.

^SICI: 1,2,1,"10.10.0.161"

After re-establishing the network connection, <con-

State> reverts to state "Up".

After closing the service with AT^SISC:

at^sici?

Query once again the current status of the connec-

tion profile.

^SICI: 1,2,0,"10.10.0.161"

Parameter <numServices> has decreased. The

bearer is still open because the service was closed

before expiry of the inactivity timeout "inactTO" of

AT^SICS.

at^sici?

Query again the current status.

^SICI: 1,0,0,"0.0.0.0"

The inactivity timeout "inactTO" of AT^SICS has

expired, therefore the bearer is closed now.

Page 261 of 567

10.3 AT^SISS

10.3

AT^SISS Internet Service Setup Profile

AT^SISS serves to set up the necessary parameters in the Internet service profiles. Any service profile can then

be used to control a data link in conjunction with AT^SISI, AT^SISO, AT^SISC, AT^SISR, AT^SISW and

AT^SISE.

The AT^SISS read command requests the current settings of all Internet service profiles. One line is issued for

every possible parameter of a given <srvParmTag> "srvType" value.

The AT^SISS write command specifies the parameters for a service profile identified by <srvProfileId>. At

first the type of Internet service needs to be selected via <srvParmTag> value "srvType". This determines the

applicability of all other <srvParmTag> values related to this "srvType" and sets their defaults. Changing the

<srvParmTag> "srvType" of an existing service profile will reset all <srvParmTag> default values to suit the

new "srvType". An exception is the <srvParmValue-alphabet> which can be set before or after selecting

"srvType" and is not reset when "srvType" changes.

To change the settings the write command needs to be executed for each single <srvParmTag>. All profile

parameters set with AT^SISS are volatile.

The list below shows which <srvParmTag> parameters apply to each Internet service and which of them are

mandatory or optional.

Table 10.2: Applicability of AT^SISS <srvParmTag> values

Mandatory or optional

Socket service

"srvType"

mandatory

"conId"

mandatory

"alphabet"

optional

"address"

mandatory

"tcpMR"

optional

"tcpOT"

optional

FTP service

"srvType"

mandatory

"conId"

mandatory

"alphabet"

optional

"address"

mandatory

"tcpMR"

optional

"tcpOT"

optional

HTTP service

"srvType"

mandatory

"conId"

mandatory

"alphabet"

optional

"address"

mandatory

"user"

optional

"password"

optional

"hcContent"

optional

"hcContLen"

optional

Page 262 of 567

10.3 AT^SISS

Syntax

Test Command

AT^SISS=?

Response(s)

Read Command

AT^SISS?

Response(s)

^SISS: <srvProfileId>, <srvParmTag>, <srvParmValue>

Write Command

AT^SISS=<srvProfileId>, <srvParmTag>, <srvParmValue>

Response(s)

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

Parameter Description

<srvProfileId>^(num)

Internet service profile identifier.

The <srvProfileId> is used to reference all parameters related to the same service profile. Furthermore,

when using the AT commands AT^SISO, AT^SISR, AT^SISW and AT^SISC the <srvProfileId> is needed

to select a specific service profile.

0...9

Internet service profile parameter.

srvType

Type of Internet service to be configured with consecutive usage of AT^SISS.

For supported values of <srvParmValue> refer to <srvParmValue-srv-

Type>.

alphabet

Selects the character set for input and output of string parameters within a pro-

file.

The selected value is bound to the specific profile. This means that different

profiles may use different alphabets. Unlike other parameters the alphabet can

be changed no matter whether the <srvParmTag> value "srvType" has been

set.

For supported values of

<srvParmValue> refer to

<srvParmValue-

alphabet>.

user

User name string

1. Socket

Not applicable.

2. FTP

Not applicable; set within "address" parameter.

3. HTTP

Length: 2 ... 31

User name for the HTTP authentication mechanism. Currently only HTTP

simple authentication is supported.

Page 264 of 567

10.3 AT^SISS

4. SMTP

User name to be used for SMTP authentication (string).

Length: 4 ... 64.

If SMTP authentication is disabled, i.e. "smAuth" flag not set, user name

parameter will be ignored.

5. POP3

User name identifying a mailbox, i.e. mailbox name (string).

Length: 1 ... 64.

passwd

Password string

1. Socket

Not applicable.

2. FTP

Not applicable; set within "address" parameter.

3. HTTP

Length: 2 ... 31

Password for the HTTP authentication mechanism. Currently HTTP simple

authentication is supported only.

4. SMTP

Password to be used for SMTP authentication (string).

Length: 4 ... 64.

If SMTP authentication is disabled, i.e. "smAuth" flag not set, password

parameter will be ignored.

5. POP3

Server/mailbox-specific password (string).

Length: 1 ... 64.

Used to perform authentication with a POP3 server.

conId

Internet connection profile to be used, for details refer AT^SICS.

tcpPort

TCP Port Number

1. Socket

Not applicable; set within "address" parameter.

2. FTP

Not applicable; set within "address" parameter.

3. HTTP

Not applicable; set within "address" parameter.

If parameter is omitted the service connects to HTTP default port 80.

4. SMTP

SMTP server TCP port number (numeric)

Length: 0 ... 2¹⁶-1

If this parameter is not set, SMTP default port number 25 is used.

5. POP3

POP3 server TCP port number (numeric)

Length: 0 ... 2¹⁶-1

If this parameter is not set, POP3 default port number 110 is used.

address

String value, depending on the service type either a URL in the case of Socket,

FTP and HTTP or an address in the case of SMTP and POP3:

1. Socket

- Socket type TCP client URL

"socktcp://'host':'remote tcpPort'[;disnagle='0|1'] "

"disnagle" is optional for disabling the TCP Nagle algorithm.

0: Nagle algorithm is enabled (default).

1: Nagle algorithm is disabled.

- Socket type TCP server URL

"socktcp://listener:'local tcpPort' "

- Socket type UDP endpoint URL

"sockudp://:'local udpPort' "

Page 265 of 567

10.3 AT^SISS

- Socket type UDP client URL

"sockudp://'host':'remote udpPort'[;size='byte'][;port='word']"

Parameter "size" (optional):

0: PDU size is variable (default).

1 ... 1500: Fixed PDU size in bytes.

Parameter "port" (optional):

0: Port number will be assigned from service (default).

1 ... 2¹⁶-1: defines the local port number for the UDP client.

FTP

- FTP client URL (get)

"ftp://'user':'password'@'host':'tcpPort'/'url-path' [;type='a|i|d'] "

Refer to "IETF-RFC 1738".

- FTP client URL (put)

"ftpput://'user':'password'@'host':'tcpPort'/'url-path'/'element

name'

[;type='a|i'][;mode='u|a|d'] "

Used parameters:

"host" is mandatory, all other parameters are optional.

If "password" is set then "user" must be set as well.

If "user" is omitted the string "anonymous" is selected for "user" and "pass-

word".

If "password" is omitted the password request is served by an empty string.

If "tcpPort" is omitted the service connects to the FTP default port 21.

If "url-path" contains only the IP address a directory listing is requested.

If "url-path" contains the IP address and has a slash '/' appended a detailed

directory listing is requested.

"type": [a)scii | i)mage | d)irectory]

"mode": [u)nique | a)ppend | d)elete]

"u)nique" selects the FTP Store Unique command to create a file name

unique to the current directory. If the file name is assigned by the server

then the "^SIS" URC will appear, indicating <urcInfoId> 2100 and the

file name.

"d)elete" clears given 'element name'.

If "mode" is omitted "replace mode" is default setting.

HTTP

HTTP client URL

Length: 6 ... 255

"http://'server'/'path':'tcpPort' "

"server": FQDN or IP-address

"path": path of file or directory

"tcpPort": If parameter is omitted the service connects to HTTP default port

80.

Refer to "IETF-RFC 2616".

SMTP SMTP server address (string).

Length: 4 ... 256.

POP3 POP3 server address (string).

Length: 4 ... 256.

hcContent

Optional parameter for HTTP method "Post".

Length: 0 ... 127

Can be used to transfer a small amount of data. The content of this string will

only be sent if "hcContLen" = 0. The maximum length of "hcContent" is 127

bytes.

To transmit a larger amount of data "hcContLen" must be set to a non-zero

value. In this case the "hcContent" string will be ignored, and data transmission

from the client to the server is done with AT^SISW.

hcContLen

Mandatory parameter for HTTP method "Post".

Length: 0 ... 2³¹-1

The content length shall be set in the header of the HTTP "Post" request before

the data part is transferred.

If "hcContLen" = 0 then the data given in the "hcContent" string will be posted.

Page 266 of 567

10.3 AT^SISS

If "hcContLen" > 0 then the AT^SISW command will be used to send data from

the client to the server. In this case, "hcContLen" specifies the total amount of

data to be sent. The data can be sent in one or several parts. For each part,

the transmission is triggered by the URC "^SISW: x, 1", then the AT^SISW write

command can be executed. After the exact number of bytes are transferred via

the serial interface, the HTTP client will go from service state "Up" to service

state "Closing" (see parameters <srvState> and <srvState> for detail).

Finally, the URC "^SISW: x, 2" indicates that all data have been transferred and

the service can be closed with AT^SISC.

hcUsrAgent

The user agent string must be set by the application to identify the mobile. Usu-

ally operation system and software version info is set with this browser identi-

fier.

Length: 0 ... 63

hcMethod

HTTP method specification: 0=GET, 1=POST, 2=HEAD.

hcProp

Parameter for several HTTP settings.

Length: 0 ... 127

The general format is 'key': <space> 'value' "\0d\0a".

Multiple settings can be given separated by "\0d\0a" sequences within the

string.

Possible 'key' values are defined at HTTP/1.1 Standard RFC 2616.

hcRedir

This flag controls the redirection mechanism of the TC65 acting as HTTP client

(numeric).

If "hcRedir" = 0: No redirection.

If "hcRedir" = 1: The client automatically sends a new HTTP request if the

server answers with a redirect code (range 30x).

Default is 1.

hcAuth

If set ("hcAuth" = 1) this flag determines that the HTTP client will automatically

answer on authentication requests from the server with the current "passwd"

and "user" parameter settings. If these parameters are not specified the TC65

will terminate the HTTP connection and send an indication to the TA.

Default is 1.

smFrom

Email sender address, i.e. "MAIL FROM" address (string).

Length: 6 ... 256

A valid address parameter consists of local part and domain name delimited by

a '@' character, e.g. "john.smith@somedomain.de".

smRcpt

Recipient address of the email, i.e. "RCPT TO" address (string).

Length: 6 ... 256

If multiple recipient addresses are to be supplied the comma character is used

as delimiter to separate individual address values, e.g. "john.smith@somedo-

main.de,tom.meier@somedomain.de".

smCC

CC recipient address of the email (string).

Length: 6 ... 256

If multiple CC recipient addresses are to be supplied the comma character is

used as delimiter to separate individual address values, e.g.

"john.smith@somedomain.de,tom.meier@somedomain.de".

smSubj

Subject content of the email (string).

Length: 0 ... 256

If no subject is supplied the email will be sent with an empty subject.

smHdr

This parameter, if set, will be appended at the end of the email header section

(string).

Length: 0... 256

Hence, it serves as a generic header field parameter which allows the user to

provide any email header field. It is the user's responsibility to provide correct

header fields!

String of max. 256 characters.

Example for multipart MIME messages:

"Content-Type: multipart/mixed".

Page 267 of 567

10.3 AT^SISS

smAuth

SMTP authentication control flag (numeric).

If disabled (<srvParmValue> "0" by default), TC65 performs action without

SMTP authentication.

If enabled (<srvParmValue> "1") authentication procedure with the SMTP

server will be performed by means of supported authentication methods, using

values of "user" and "passwd" parameters. If TC65 and SMTP server are not

able to negotiate an authentication mechanism supported by both parties, the

TC65 continues action without authentication.

TC65 supports SMTP authentication.

pCmd

POP3 user command to be executed by the POP3 service (numeric).

For supported values of <srvParmValue> refer to <srvParmValue-pCmd>.

pNumber

Optional message number argument used by the POP3 commands List ("2"),

Retrieve ("3") and Delete ("4"). For POP3 commands see <srvParmTag>

value "pCmd".

Length: 0 ... 2³²-1

If no specific value is set in the service profile, the value "0" is assumed by

default, i.e. "pNumber" is disabled.

pLength

Maximum message length (string, optional)

Length: 0 ... 2³²-1

"pLength" can be used to specify the length of the message(s) to be retrieved

from or deleted on the POP3 server. If no specific value is set in the service

profile, the default value "0" is assumed, which means that there is no limit on

the message size.

A warning will be issued inthe following cases:

• If "pNumber" > 0 and a specific message to be retrieved from / deleted on

the server is longer than "pLength".

• If "pNumber" = 0 and all messages to be retrieved from / deleted on the

server are longer than "pLength".

No warning will be issued in the following cases:

• If there are no messages at all on the server.

• If the server has message(s) below and above the "pLength" specified. In

this case, the message(s) within the range of "pLength" can be successfully

retrieved or deleted, but the message(s) above "pLength" remain on the

server without any further notification given to the user.

• Therefore, after retrieving / deleting messages, it is recommended to check

the message status on the server. This can be done by adding a further

POP3 service profile using the POP3 user command List ("2").

pDelFlag

Flag to be used with the POP3 user command Retrieve ("3"). Specifies whether

or not to delete retrieved emails on the server (optional).

For supported values of

<srvParmValue> refer to

<srvParmValue-

pDelFlag>.

tcpMR

Parameter can be used to overwrite the global AT^SCFG parameter "Tcp/

MaxRetransmissions" <tcpMr> for a specific Internet Service connection pro-

file. If the parameter is not specified the value specified with AT^SCFG will be

used.

Supported values <srvParmValue> for this parameter are the same as

described for <tcpMr>.

Setting is not relevant for Internet Service "Socket" whit type "UDP".

tcpOT

Parameter can be used to overwrite the global AT^SCFG parameter "Tcp/Over-

allTimeout" <tcpOt> for a specific Internet Service connection profile. If the

parameter is not specified the value specified with AT^SCFG will be used.

Supported values <srvParmValue> for this parameter are the same as

described for <tcpOt>.

Setting is not relevant for Internet Service "Socket" whit type "UDP".

Page 268 of 567

10.3 AT^SISS

<srvParmValue>^(str)

Parameter value; type and supported content depend on related <srvParmTag>.

<srvParmValue-srvType>^(str)

Supported Internet service type values in <srvParmValue> for <srvParmTag> value "srvType".

Before changing the "srvType" of an existing service profile be sure that the profile is closed. To verify the con-

nection state of the service profile enter the read command AT^SISI. Only when <srvState>=2 is returned

for this specific service profile you can change its service type.

"Socket"

TC65 acting as client or server (listener) for TCP or UDP.

If TC65 is listener at least two service profiles are required. The first socket pro-

file must be configured as listener. The second service profile will be dynami-

cally assigned when a socket connection request from a remote client is

incoming. For this purpose, one service profile must be left free (= not config-

ured with AT^SISS). An incoming socket connection request will be indicated

by the "^SIS" URC, with the next free <srvProfileId> shown inside the

URC as parameter <urcInfoId>. The connection request can be accepted

or rejected by using the commands AT^SISO or AT^SISC and the ID retrieved

from the "^SIS".

"Ftp"

TC65 acting as FTP client.

"Http"

TC65 acting as HTTP client.

"Smtp"

TC65 acting as SMTP client.

"Pop3"

TC65 acting as POP3 client.

"none"

Reset Internet service profile settings. Operation is not allowed if profile is in

use, i.e. it was activated via AT^SISO.

<srvParmValue-alphabet>^(str)

Supported string parameter character set selections in <srvParmValue> for <srvParmTag> value "alphabet".

["0"]

Applicable character set is determined by current setting of AT+CSCS.

"1"

International Reference Alphabet (IRA, seven bit ASCII).

<srvParmValue-pCmd>^(num)

Supported POP3 user command values in <srvParmValue> for <srvParmTag> value "pCmd".

Status command.

This command retrieves the "drop listing" of a POP3 server. A "drop listing"

consists of a single line containing the number of messages in the maildrop list

followed by the total size of the maildrop list in bytes. Each drop listing will be

finished by a so-called "dotline", i.e. a new line with just a single dot.

List command.

If <srvParmTag> value "pNumber" is set to a non-zero value the "List" com-

mand returns the "scan listing", consisting of a single line which contains the

message number and the message size in bytes if the specified message

exists in the maildrop list on the POP3 server.

If no such message exists on the server than the POP3 service issues an error

response to the user.

If <srvParmTag> value "pNumber" is zero the "List" command returns a multi-

line "scan listing". For each message on the maildrop list of the server the

POP3 service returns a line containing the message number and its size in

bytes. A final "dotline" will be printed at the end of the "scan listing".

If there are no messages on the maildrop list of the server, the POP3 service

returns a positive response, i.e. it doesn't issue an error response, but the

"scan listing" will be empty.

In either case, each scan listing will be finished by a so-called "dotline", i.e. a

new line with just a single dot.

Page 269 of 567

10.3 AT^SISS

Retrieve command.

If <srvParmTag> value "pNumber" is set to a non-zero value this command

retrieves the related message from the POP3 server's maildrop list.

If no such message exists on the server the POP3 service issues an error

response to the user.

It depends on the parameter "pDelFlag" if the message will be deleted from the

POP3 server upon successful retrieval.

If <srvParmTag> value "pNumber" is zero the "Retrieve" command returns all

messages pending in the POP3 server's maildrop.

If there are no messages on the maildrop list of the server the POP3 service

returns with a positive response, i.e. it doesn't issue an error response, but the

returned list will be empty.

Each email will be finished by a so-called "dotline", i.e. a new line with just a

single dot.

Delete command

If <srvParmTag> value "pNumber" is set to a non-zero value the command

deletes the related message from the POP3 server's maildrop list. In fact, the

message is marked as deleted on the server and will be deleted permanently

if the POP3 service command executes successfully. In case an error has

occurred, e.g. network loss, the message will not be deleted on the server even

though the POP3 service command has been finished.

If <srvParmTag> value "pNumber" is zero the "Delete" command deletes all

messages from the POP3 server's maildrop list. In fact, the messages are

marked as deleted on the server and will be deleted permanently if the POP3

service command executes successfully. In case an error has occurred, the

messages will not be deleted on the server even though the POP3 service

command has been finished.

<srvParmValue-pDelFlag>^(num)

Supported flag values in <srvParmValue> for <srvParmTag> value "pDelFlag". Only applicable if the profile

contains the POP3 user command Retrieve ("3").

[0]

Messages will not be deleted on the server.

Delete messages on the server which have been retrieved successfully.

Note

• String parameters are truncated if greater than the maximum length specified above.

Page 270 of 567

10.4 AT^SISI

10.4

AT^SISI Internet Service Information

AT^SISI serves to monitor the status of Internet service profiles defined with AT^SISS.

The AT^SISI read command requests the current status of all defined Internet service profiles.

The AT^SISI write command requests the status of the specified Internet service profile. If the specified service

profile is not defined yet, "+CME ERROR" is returned.

Syntax

Test Command

AT^SISI=?

Response(s)

[^SISI:(list of defined <srvProfileId>s)]

Read Command

AT^SISI?

Response(s)

If response is related to service profile(s) created / opened on this interface:

[^SISI: <srvProfileId>, <srvState>, <rxCount>, <txCount>, <ackData>, <unackData>]

[^SISI: ...]

If response is related to service profile(s) created / opened on other interface(s):

[^SISI: <srvProfileId>, <srvParmTag>value "srvType"]

[^SISI: ...]

ERROR

Write Command

AT^SISI=<srvProfileId>

Response(s)

^SISI: <srvProfileId>, <srvState>, <rxCount>, <txCount>, <ackData>, <unackData>

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

Page 271 of 567

10.4 AT^SISI

Parameter Description

<srvProfileId>^(num)

Internet service profile identifier as defined by AT^SISS (<srvProfileId>).

0...9

<srvState>^(num)

Internet service state (for details see AT^SISO parameter <srvState>).

Allocated

Connecting

Closing

Down

<rxCount>^(num)

Number of bytes received via AT^SISR since last successful AT^SISO write command.

This is the same value as displayed by the AT^SISO read command with the parameter <rxCount>.

<txCount>^(num)

Number of bytes sent via AT^SISW since last successful AT^SISO write command.

This is the same value as displayed by the AT^SISO read command with the parameter <txCount>.

<ackData>^(num)

Number of data bytes already sent and acknowledged at TCP layer. Value 0 indicates that no sent data is

acknowledged yet.

Parameter is not applicable to HTTP, POP3, SMTP and Socket with UDP. For these services the counter is

always set to 0.

<unackData>^(num)

Number of data bytes already sent but not yet acknowledged at TCP layer. A value 0 indicates that all sent data

is already acknowledged.

This is the same value as displayed in the response of the AT^SISW write command with the parameter

<unackData>.

Parameter is not applicable to HTTP, POP3, SMTP and Socket with UDP. For these services the counter is

always set to 0.

Note

• If a service is in state "Down" the responses for <rxCount>, <txCount>, <ackData> and <unackData>

are the last known values for the service in the states "Connecting", "Up" and "Closing".

Page 272 of 567

10.5 AT^SISO

10.5

AT^SISO Internet Service Open

The AT^SISO write command starts the Internet session configured by the service profile. All further steps

needed to control the session depend on whether you are using URC mode or polling mode. The AT^SISO read

command returns the current status of all services.

URC mode:

If the service opens successfully, the URCs "^SISW" and "^SISR" will trigger the action to follow, either writing

data with AT^SISW or reading data with AT^SISR. To terminate an upload data stream set the <eodFlag>

within the last AT^SISW command. If the URCs notify that a data transfer has been successful ("^SISR: x, 2" or

"^SISW: x, 2"), the service can be closed with AT^SISC. If a special event occurs, e.g. an error or a warning,

after opening or while using a service then the URC type "^SIS" will be delivered.

Polling mode:

After opening the service, all progress information needed to control the session shall be explicitly requested by

the host application. The particular sequence of AT commands varies depending on the service used. The fol-

lowing list summarizes, by way of an example, the steps normally involved in managing an upload or download

job.

•

Upload (Socket, FTP, HTTP, SMTP):

- Enter the AT^SISO command, e.g. AT^SISO=9.

- Enter AT^SISW, specify <reqWriteLength>, e.g. AT^SISW=9,20. Check resulting response for <cnf-

WriteLength>. Optionally, check error with AT^SISE, e.g. AT^SISE=9. If necessary, repeat the

sequence several times.

- Enter last AT^SISW command and enable <eodFlag>, e.g. AT^SISW=9,0,1.

If Socket service: Query available data with AT^SISR, e.g. AT^SISR=9,1430.

- Check service state with AT^SISI, e.g. AT^SISI=9, if necessary several times until <srvState>=6

("Down").

- Check error with AT^SISE, e.g. AT^SISE=9.

- Close service with AT^SISC, e.g. AT^SISC=9.

•

Download (Socket, FTP, HTTP, POP3):

- Enter the AT^SISO command, e.g. AT^SISO=9.

- Enter AT^SISR, specify <reqReadLength>, e.g. AT^SISR=9,1000. Check resulting response for

<cnfReadLength>. If necessary, repeat the sequence several times until <cnfReadLength>= -2 (end

of data) or ERROR.

- Check error with AT^SISE, e.g. AT^SISE=9.

- Close service with AT^SISC, e.g. AT^SISC=9.

•

Socket service (upload and download possible in one session):

- Recommended: Set AT+CMEE=2 to enable extended error text.

- Enter the AT^SISO command, e.g. AT^SISO=9.

- Enter AT^SISR or AT^SISW, specifying

<reqReadLength> or

<reqWriteLength>, e.g.

AT^SISR=9,20 or AT^SISW=9,20. Check resulting response for <cnfReadLength> or <cnfWrite-

Length>. If necessary, repeat the sequence several times.

- Check error with AT^SISE, e.g. AT^SISE=9.

- If write action: Enter last AT^SISW command and enable <eodFlag>, e.g. AT^SISW=9,0,1.

If Socket service: Query available data with AT^SISR, e.g. AT^SISR=9,1430.

- Close service with AT^SISC, e.g. AT^SISC=9.

Syntax

Test Command

AT^SISO=?

Response(s)

Page 273 of 567

10.5 AT^SISO

Read Command

AT^SISO?

Response(s)

^SISO: <srvProfileId>, <srvParmTag>value "srvType" [, <srvState>, <socketState>,

<rxCount>, <txCount>, <locAddr>, <remAddr>]

[^SISO: ...]

Write Command

AT^SISO=<srvProfileId>

Response(s)

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

Parameter Description

<srvProfileId>^(num)

<srvProfileId> 0 ... 9 specified with AT^SISS.

<srvState>^(num)

Internet service state.

Please note, that the state of an Internet service may influence the state of the serial DCD line. For details see

description of value 2 for parameter <value> of command AT&C.

Allocated

Service profile resources are allocated, i.e. at least the service type has been

set (parameter <srvParmTag>, value "srvType" of AT^SISS). The service is

not opened, but ready for configuration.

Connecting

State after opening a service with AT^SISO where the connection is being

established.

If connection setup is successful the service proceeds to the state "4" (Up) and

one of the URCs "^SISW" and "^SISR" may follow. If connection setup is not

successful, the "^SIS" URC may appear and the service enters <srvState>

6 (Down).

In the case of FTP, <srvState>=3 means that the command channel is being

established.

If the service profile is configured as Socket listener, then the listener always

stays at <srvState>=3 and <socketState>=3 (LISTENER), while the

<srvState> and <socketState> of the dynamically assigned service pro-

file may change. See examples in Section 10.5.1.

The service performs its purpose. The data transfer process is the major func-

tion at this state.

FTP: Data channel is up.

SMTP: The SMTP service will not enter <srvState>=4 until the host has writ-

ten the first data packet with AT^SISW.

Closing

Internet Service is closing the network connection.

FTP: Command channel is released.

Page 274 of 567

10.5 AT^SISO

Down

This state is entered if

- the service has successfully finished its session (see note on Socket),

- the remote peer has reset the connection or

- the IP connection has been closed because of an error.

If a service in this state be sure to close it with AT^SISC before reopening it.

<socketState>^(num)

Socket state identifier.

Socket not assigned, i.e. no TCP/UDP connection active.

Socket assigned as CLIENT.

Socket assigned as LISTENER.

Socket assigned as SERVER.

<rxCount>^(num)

Number of bytes received via AT^SISR since last successful AT^SISO write command.

<txCount>^(num)

Number of bytes sent via AT^SISW since last successful AT^SISO write command.

<locAddr>^(str)

Recently used local IP address in dotted-four-byte format and TCP port, separated by colon, e.g.

"192.60.10.10:80".

<remAddr>^(str)

Remote IP address in dotted-four-byte format and TCP port, separated by colon, e.g. "192.60.10.10:80".

Notes

• If the bearer cannot be established and AT^SISO returns an error there might be a general GSM/GPRS prob-

lem. To identify the reason you can take advantage of the AT+CEER command. Using AT+CEER is especially

recommended when the <infoID> parameter of the AT^SISE command equals 0.

• As in polling mode no error URCs are available you are advised to integrate the commands AT^SISI and

AT^SISE into the command sequences for upload and download jobs. So, the AT^SISO command may be

followed by AT^SISI to check that the service has entered the <srvState>=4 before sending AT^SISR or

AT^SISW. This helps you to detect errors even though the "^SIS" URCs are disabled. A typical example is

that the service fails to be opened because the service profile contains a wrong destination address. In such

a case, after opening with AT^SISO and OK response, the service quickly enters the states <srvState>=2,

4 and 6, with an error being returned no earlier than after sending the first AT^SISR or AT^SISW command.

In URC mode, an error URC, such as "Host not found" would be received in this situation, but in polling mode

the only way to detect the state is using AT^SISI or, alternatively, AT^SISO.

• If the user rapidly closes and opens TCP/IP connections based on the embedded TCP/IP stack the service

may display the error "No buffer space available", meaning that all TCP/IP socket resources are exhausted.

In the worst case, opening further TCP/IP connections is locked for up to 60 seconds.

• The Socket Listener may not work properly if the service is re-opened shortly after having closed the Socket

Listener. To ensure that the service works correctly the host is required to wait at least two minutes before re-

opening a Listener.

Page 275 of 567

10.5 AT^SISO

10.5.1

Example: Accepting / Rejecting Socket Connection Request

from Remote Client

Host 1 configured as Socket listener with IP address 10.10.0.187 at port 65534 is receiving a connection request

from the remote client 10.10.0.185 (at port 1024). The example assumes that connection and service profiles

have been created as stated earlier.

Start the Socket service in listener mode, then query the IP address dynamically assigned to the Socket listener:

at^siso=4

Host 1 opens the Socket service.

at^siso?

Query the current status of all services. All service

^SISO: 0, ""

profiles are unused, except for service profile

^SISO: 1, ""

which is running in listener mode, where

<srvState>=3 (listening) and <socketState>=3

^SISO: 2, ""

(LISTENER). The response also indicates the IP

^SISO: 3, ""

address dynamically assigned to the listener. The lis-

tener's access data (IP address and TCP port num-

ber) shall be passed on to the client.

^SISO: 4, "Socket","3","3","0","0","10.10.0.187:65534","0.0.0.0:0"

^SISO: 6, ""

^SISO: 7, ""

^SISO: 8, ""

^SISO: 9, ""

Indication of incoming Socket connection request:

^SIS: 4, 1, 0

The URC indicates that the listener configured on

service profile 4 is receiving a Socket connection

request (<urcCause>=1) from the remote client.

The last URC parameter <urcInfoId> represents

the ID of the dynamically assigned service profile,

here 0.

at^siso?

Query the current status of services.

^SISO: 0, "Socket","2","4","0","0",

Indication on host 1 that the connection request from

"10.10.0.187:0","10.10.0.185:1024"

the remote client has been dynamically assigned to

^SISO: 1, ""

service profile

0 which is set to Server mode

^SISO: 2, ""

(<socketState>=4).

^SISO: 3, ""

^SISO: 4, "Socket","3","3","0","0", "10.10.0.187:65534","0.0.0.0:0"

^SISO: 6, ""

^SISO: 7, ""

^SISO: 8, ""

^SISO: 9, ""

Host 1 accepts the Socket connection request:

at^siso=0

Host 1 accepts the connection request, where 0 is

the ID of the dynamically assigned service profile.

^SISW: 0, 1

The URC indicates that data transmission to the

remote client is possible. If the remote client has

already sent some data the additional URC ^SISR:

0,1 is displayed.

at^siso?

Query the current status of services.

^SISO: 0, "Socket","4","4","0","0",

The socket connection between host 1 and remote

"10.10.0.187:65534","10.10.0.185:1024"

client is successfully established.

^SISO: 1, ""

^SISO: 2, ""

^SISO: 3, ""

^SISO: 4, "Socket","3","3","0","0","10.10.0.187:65534","0.0.0.0:0"

Page 276 of 567

10.7 AT^SISR

10.7

AT^SISR Internet Service Read Data

The AT^SISR command either triggers a read operation (download) or queries the number of bytes in the internal

buffer.

The AT^SISR write command may return the following errors:

• "+CME ERROR: operation failed" if there is a problem on application, socket, PPP or GPRS/GSM level. The

AT^SISE command and the "^SIS" URC offer additional error information.

• "+CME ERROR: operation temporary not allowed" e.g. if the service has not network resources allocated.

• "+CME ERROR: operation not allowed" e.g. if the service is not configured.

Syntax

Test Command

AT^SISR=?

Response(s)

Write Command

AT^SISR=<srvProfileId>, <reqReadLength>

Response(s)

^SISR: <srvProfileId>, <cnfReadLength>[, <remainUdpPacketLength>[, <optServParm>]]

Number of data bytes are sent as specified by <cnfReadLength>. If peek operator was used no data bytes

are sent.

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

Unsolicited Result Code

^SISR: <srvProfileId>, <urcCauseId>

Data availability status of the Internet service configured with AT^SISS has changed. The URC is issued when:

• data is available after opening an Internet service or

• less data was confirmed (in <cnfReadLength>) than requested (with <reqReadLength>) during the last

"Read Data" operation and new data is available.

The URC is disabled in polling mode. See AT^SCFG, parameter "Tcp/WithURCs", <tcpWithUrc>.

Parameter Description

<srvProfileId>^(num)

<srvProfileId> 0 ... 9 specified with AT^SISS.

<reqReadLength>^(num)

Peek Operator: Query number of received bytes within internal buffers.

The behaviour of the peek operator depends on the selected Internet service,

i.e. it may not be supported by all IP Services.

For "Socket" service configured for UDP the size of the next available UDP

packet is returned.

1...1500

Requested number of data bytes to be read via the Internet service specified

in <srvProfileId>.

Page 279 of 567

10.7 AT^SISR

<cnfReadLength>^(num)

-2

Indicates end of data. Data transfer has been finished (all data have been read)

and the service can be closed with AT^SISC.

-1

Applies only to HTTP: Querying number of available bytes is not supported by

the HTTP service.

Indicates that no further is are available at the moment.

Number of available data bytes. The range is determined by

<reqReadLength>:

If <reqReadLength> was greater than 0, then <cnfReadLength> may be

less or equal to the value requested with <reqReadLength>.

<reqReadLength> equals 0 (peek operator) the value indicated by

<cnfReadLength> may be greater than 1500.

<urcCauseId>^(num)

Indicates whether or not data is available for reading with AT^SISR.

Data is available and can be read by sending the AT^SISR command. The

URC appears when less data was confirmed (in <cnfReadLength>) than

requested (with <reqReadLength>) during the last "Read Data" operation

and new data is available.

End of data. Data transfer has completed (all data read). The service can be

closed with AT^SISC.

<remainUdpPacketLength>^(num)

Optional third parameter of the AT^SISR write command response displayed only if the Socket service uses the

UDP protocol.

The reception of each datagram must be completed before the next datagram can be received. This may be a

problem if the buffer of the host application is limited and not designed to handle the maximum packet size of

1500 bytes. To compensate this, the host is advised to request, via <reqReadLength>, an amount less or

equal its maxmimum buffer capacity and wait for the resulting AT^SISR write command response with param-

eter <remainUdpPacketLength>. The benefit of this approach is that the host may properly receive all parts

of a UDP datagram, as after each received data part the number of remaining bytes is synchronized, until read-

ing the datagram is finished.

If the currently read datagram is smaller than the number of bytes requested by the host the <remainUdpPack-

etLength> parameter is omitted.

Further write attempts with AT^SISR are denied as long as the <remainUdpPacketLength> is unequal 0 or

is not omitted. In this case the service returns "+CME ERROR: operation of service temporary not allowed".

Indicates that all bytes of the current UDP datagram are read.

1...(max. data size)-1

Indicates that the currently read UDP datagram is not yet complete. The dis-

played value is the remaining number of bytes.

<remainUdpPacketLength> is unequal 0 until reading all parts of the cur-

rent datagram is finished.

<optServParm>^(str)

Service specific parameter of the AT^SISR write command response. If the Socket service is configured as UDP

endpoint this parameter returns the IP address and the UDP port of the remote host that has sent the current

UDP data.

Page 280 of 567

10.7 AT^SISR

10.7.1

Example: Socket Host Reads Small Amounts of UDP Data Pack-

ets (URC Mode)

This section applies only to the Socket service using the UDP protocol. The example shows how to read UDP

packets if the buffer of the host application can handle only a few bytes. There are two datagrams available for

reading.

Buffer size: 6 bytes

Datagram A = 18 bytes (content "THIS_IS_DATAGRAM_A")

Datagram B =

3 bytes (content "NEW")

^SISR: 0,1

Service profile 0 is configured for Socket service and UDP. The URC

notifies host that data is available for reading.

at^sisr=0,6

The host requests to read 6 bytes.

^SISR: 0,6,12

The first 6 bytes of datagram A are confirmed and transmitted. Another

THIS_I

12 bytes are still available.

at^sisr=0,6

The host requests to read the next part of 6 bytes.

^SISR: 0,6,6

The next 6 bytes of datagram A are confirmed and transmitted. Another

S_DATA

6 bytes are still available.

at^sisr=0,6

The host requests to read the next part of 6 bytes.

^SISR: 0,6,0

Last part of datagram A was received, no remainder is left.

GRAM_A

at^sisr=0,6

Again, the host requests to read 6 bytes. This time, the request refers to

datagram B which has only 3 bytes. As the read datagram is smaller

than the size requested by the host, the response does not include the

<remainUdpPacketLength>.

^SISR: 0,3

3 bytes are confirmed and transmitted. Datagram B was properly

NEW

received.

Page 281 of 567

10.8 AT^SISW

10.8

AT^SISW Internet Service Write Data

The AT^SISW command triggers a write operation (upload) and queries the amount of data already sent, but not

acknowledged at the TCP layer. The write operation may be run in binary mode, or in interactive text mode.

The AT^SISW write command may return the following errors:

• "+CME ERROR: operation failed" if there is a problem on application, socket, PPP or GPRS/GSM level. The

AT^SISE command and the "^SIS" URC offer additional error information.

• "+CME ERROR: operation temporary not allowed" e.g. if the service has not network resources allocated.

• "+CME ERROR: operation not allowed" e.g. if the service is not configured.

Syntax

Test Command

AT^SISW=?

Response(s)

Write Command

AT^SISW=<srvProfileId>, <reqWriteLength>[, <eodFlag>[, <mode>[, <optServParam>]]]

Response(s)

^SISW: <srvProfileId>, <cnfWriteLength>, <unackData>

Number of data bytes as specified by <cnfWriteLength>.

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

Unsolicited Result Code

^SISW: <srvProfileId>, <urcCauseId>

Data availability status of the Internet service configured with AT^SISS has changed. The URC is issued when

the service is ready to accept new user data.

The URC is disabled in polling mode. See AT^SCFG, parameter "Tcp/WithURCs", <tcpWithUrc>.

Parameter Description

<srvProfileId>^(num)

<srvProfileId> 0 ... 9 specified with AT^SISS.

<reqWriteLength>^(num)

0...1500

Specifies the number of bytes to be sent with AT^SISW or, if set to 0, requests the amount of data already sent

with AT^SISW but not yet acknowledged:

• Parameter <reqWriteLength> may be 1...1500 bytes to specify the amount of data to be sent with

AT^SISW.

• If parameter <reqWriteLength> equals 0, AT^SISW does not expect any data, but a normal query is per-

fomed. This allows the application to explictly request, in particular at the end of an upload job, the amount of

unacknowledged data at the TCP layer indicated by <unackData>.

• In interactive text mode, <reqWriteLength> must be set to any value greater than 0 (but not necessarily

the precise number of bytes). If set to 0 in interactive text mode, <reqWriteLength> would be interpreted

as query for unacknowledged data and, thus, prevent data transfer.

Page 282 of 567

10.8 AT^SISW

• If Socket service is selected with UDP protocol

<reqWriteLength>=0 can be used to send an empty UDP packet;

- it is recommended that the size of each data packet be limited to 1472 bytes. Otherwise, it is possible that

the following URC occurs: "^SIS: <id>, 0, 9, The supplied buffer was too small / large".

<eodFlag>^(num)

End of data indication flag.

Parameter is ignored for HTTP, POP3, FTP download, Socket with UDP protocol.

[0]

No end of data. Other data may follow to be transmitted via the Internet service.

End of data is signalled to the Internet Service. Further AT^SISW write com-

mands return an error response. However, reading data may be possible. The

<eodFlag> is effective only if the <reqWriteLength> equals <cnfWrite-

Length>, in particular if the <reqWriteLength> equals 0.

If <mode> equals 1 the <eodFlag> is effective only if the write operation has

been finished with CTRL-Z.

<mode>^(num)

Control how the application provides the data bytes to be sent.

[0]

Binary mode

This mode allows sending a number of bytes defined with parameter

<reqWriteLength>.

Interactive text mode

This mode allows the user to type and send 8-bit ASCII characters while the

service is open. Ctrl-Z terminates data input and causes the data to be trans-

ferred.

Interactive text mode requires that the <reqWriteLength> is set to any value

greater than 0 (though it is not necessary to specify the precise number of

bytes). In this case the <cnfWriteLength> parameter indicates the maxi-

mum length of the data stream without control character CTRL-Z. The

<txCount> counter is incremented only by the portion of data actually trans-

mitted.

In interactive text mode, the following characters are predefined as control

codes:

• BACKSPACE ("\x08") deletes the last given character,

• CTRL-Z ("\x1a") terminates the input,

• ESC ("\x1b") aborts the command. An <eodFlag> is ignored in this case.

The V.25 command ATE also controls the echo mode of the interactive text

mode. If echo is enabled (ATE1) all characters are echoed until <cnfWrite-

Length> is reached. Any attempt to input further data ends up with the warn-

ing message 4001 indicated after the data stream has been completed with

CTRL-Z, nevertheless all data within the range of <cnfWriteLength> will be

sent. See also Section 10.13, Internet Service URC "^SIS". ATE0 disables the

echo mode generally.

<optServParam>^(str)

Service specific parameter of the AT^SISW write command. If the Socket service is configured as UDP endpoint

this parameter is mandatory and specifies the IP address (in dotted format) and the UDP port of the remote host.

For each write request another IP address and UDP port may be given.

<cnfWriteLength>^(num)

0...1500

Confirmed number of data bytes which can be transmitted via the Internet ser-

vice configured in <srvProfileId>. In binary mode (see <mode>) this num-

ber may be less or equal to the value requested with <reqWriteLength>.

The application has to deliver exactly the number of bytes indicated by <cnf-

Page 283 of 567

10.8 AT^SISW

WriteLength>. A 0 value means that no data can be written at this time, i.e.

it serves as a flow control mechanism.

In interactive text mode, <cnfWriteLength> indicates the maximum number

of bytes it can process. Characters above the indicated number are ignored.

<unackData>^(num)

Number of data bytes already sent but not yet acknowledged at the TCP layer.

The value is constantly changing until the entire upload job has completed. If the value equals 0 all data sent so

far is acknowledged.

In binary mode, <unackData> includes the <cnfWriteLength> value of the pending write operation. There-

fore, the very first write operation of an upload job returns identical values for <cnfWriteLength> and

<unackData>.

This mechanism allows the host application to easily verify whether or not the remote host has successfully

received the data.

Parameter is not applicable to HTTP, POP3, SMTP and Socket with UDP protocol. For these services the

counter is always set to 0.

<urcCauseId>^(num)

The service is ready to accept new user data.

Data transfer has been finished successfully and Internet service may be

closed without loss of data.

Notes

• The AT^SISW write command must be terminated only with the ASCII character set with ATS3. The factory

default for S3 is #13 (Carriage Return). Do not send any further characters after the S3 end-of-line identifier,

until the response "^SISW" is received. This is necessary to avoid that any characters related to the AT com-

mand can be interpreted as being part of the data stream to be transferred. Also refer to Section 1.4, AT Com-

mand Syntax.

• If the Socket service is configured for use as UDP client and fixed size and the interactive text mode is active,

the PDU length always equals the specified fixed length. If the input characters exceed the specified fixed

length, then all surplus characters will be ignored. If the input characters are less than the specified fixed

length, then the remaining range will be filled with "\0" bytes.

10.8.1

Usage of parameter <eodFlag>

Service type

Socket

After the service accepts the end-of-data flag the service state changes to "Closing". No fur-

ther user data is accepted.

After releasing the TCP link the service remains in state "Down".

Parameter is not applicable to Socket with UDP protocol, i.e. value is ignored.

FTP

Parameter only applicable for FTP upload session.

After accepting the end-of-data flag the service state changes to "Closing" and starts to end

the running FTP session.

No further user data is accepted.

After the FTP session is completed on FTP protocol level the service state switches to "Down".

In case of successful completion the URC "^SISW: x,2" is generated.

Page 284 of 567

10.9 AT^SICO

10.9

AT^SICO Internet Connection Open

The AT^SICO write command opens a connection profile (also referred to as bearer). Unlike the AT^SISO com-

mand which starts a connection profile and the service profile bound to it, AT^SICO activates only the selected

connection profile. Another difference over AT^SISO is that AT^SICO disables the inactivity timeout of the

selected connection profile and, therefore, sets the "inactTO" value to -1 (see also AT^SICS). To release the

connection use the close command AT^SICC. Closing the bearer restores the previously set "inactTO" value of

the concerned connection profile.

The AT^SICO command may be used, for example, to keep a bearer open while no service is active (i.e. while

no service has been opened with AT^SISO). Also, the AT^SICO command is necessary for running the Ping

command AT^SISX when no service has been opened with AT^SISO.

A connection opened with AT^SICO remains open until closed with AT^SICC or, in case of inactivity, discon-

nected by the network after 25 hours usually. The network initiated disconnection can be avoided by sending

AT^SISX at regular intervals (Ping). The Round Trip Time (RTT) of the AT^SISX command strongly depends

on the data traffic of the IP services or DUN connections used at the same time.

Please note that after sending the AT^SICO write command the AT channel is blocked until the connection is

established. The command may be aborted when receiving any character during execution, e.g. "AT" or "at".

The AT^SICO read command requests the current settings of all Internet connection profiles set with AT^SISC.

The output is identical with the read command response of AT^SISC. One line is issued for every possible

parameter of a given <conParmTag> value.

Syntax

Test Command

AT^SICO=?

Response(s)

[^SICO:(list of defined <conProfileId>s)]

Read Command

AT^SICO?

Response(s)

[^SICO: <conProfileId>, <conParmTag>, <conParmValue>]

[^SICO: ...]

Write Command

AT^SICO=<conProfileId>

Response(s)

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

Parameter Description

<conProfileId>^(num)

0...5

Internet connection profile identifier defined with parameter <conProfileId>

of AT^SICS.

Page 286 of 567

10.10 AT^SICC

10.10

AT^SICC Internet Connection Close

The AT^SICC write command releases a connection opened with AT^SICO and restores the previously set inac-

tivity timeout "inactTO" of the selected connection profile.

The command returns an error if any services are bound to this profile. Before using the AT^SICC write com-

mand be sure that all services were closed with AT^SISC.

Syntax

Test Command

AT^SICC=?

Response(s)

[^SICC:(list of defined <conProfileId>s)]

Write Command

AT^SICC=<conProfileId>

Response(s)

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

Parameter Description

<conProfileId>^(num)

0...5

Internet connection profile identifier defined with parameter <conProfileId>

of AT^SICS.

Note

• Be sure not to mix up the start and close commands connection profiles and service profiles. It is allowed to

use only the combinations AT^SICO / AT^SICC or AT^SISO / AT^SISC.

Page 288 of 567

10.11 AT^SISX

10.11

AT^SISX Internet Service Execution

The AT^SISX command sends ICMP (Internet Control Message Protocol) Echo Requests to a target IP address

or host name (also referred to as Ping command).

The AT^SISX command can be used any time while a connection profile, i.e. a bearer, is active. The bearer may

have been started either with AT^SICO, or if a service is in use, with AT^SISO. If issued although no bearer is

active or no connection profile created at all, AT^SISX returns ERROR.

The AT^SISX write command starts the available service type <service>, i.e. the ping command. The com-

mand returns one row for every ICMP Echo Request (max. 30 lines, see parameter <request>). The last Ping

response line is followed by an empty line, then another two lines appear to report a statistic calculated from the

Echo Request responses. To stop the periodic ping type any character, e.g. "AT" or "at". After calling the ping

command the AT channel is blocked until all ICMP requests are executed.

Sending the Ping command does not restart the inactivity timeout "inactTO" of the used connection profile (see

AT^SICS), i.e. if the bearer was opened with AT^SICO the "inactTO" value remains "-1" (= inactivity timeout dis-

abled), and if the bearer was opened with AT^SISO the "inactTO" value set with AT^SICS remains applicable.

The Ping command can only be used to prevent that a network initiated inactivity timeout closes the bearer (see

also description of AT^SICO).

Syntax

Test Command

AT^SISX=?

Response(s)

^SISX:<service>, (list of supported <conProfileId>s), <address>, (range of <request>), (range of

<timelimit>)

Write Command

AT^SISX=<service>, <conProfileId>, <address>[, <request>, <timelimit>]

Response(s)

In case of <pingInfoType>= 1: ICMP Echo Requests (1 - 30 rows)

^SISX:<service>, <pingInfoType>, <conProfileId>, <address>, <roundTripTime>

[...]

In case of <pingInfoType>= 2: Packet statistic (1 row)

^SISX:<service>, <pingInfoType>, <conProfileId>, <sent>, <received>, <lost>,

In case of <pingInfoType>= 3: Time statistic (1 row)

^SISX:<service>, <pingInfoType>, <conProfileId>, <minRTT>, <maxRTT>, <meanRTT>

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

Page 289 of 567

10.11 AT^SISX

Parameter Description

<service>^(str)

"Ping"

Service type.

<conProfileId>^(num)

0...5

Internet connection profile identifier defined with parameter <conProfileId>

of AT^SICS.

<address>^(str)

Target host name or IP address for pinging (i.e. 192.168.1.3).

<request>^(num)

[1]...30

Number of ping requests (ICMP Echo Requests).

<timelimit>^(num)

200...[5000]...10000

Amount of time, in milliseconds, to wait for an Echo Response message related

to a sent Echo Request message.

<pingInfoType>^(num)

Marks the type and format of the information given in the command responses (see syntax of the AT^SISX write

command above).

Ping response(s) received for the ICMP Echo Request(s). Depending on

parameter <request> 1 - 30 rows. Address and Round Trip Time are returned

for each request.

1-row packet statistic calculated from the ping response(s) received for

<pingInfoType>=1.

1-row time statistics calculated from the ping response(s) received for <ping-

InfoType>=1.

<roundTripTime>^(num)

Round Trip Time in milliseconds. If the Echo Response message is not received within the time specified by

<timelimit> the value -1 is returned (e.g. when the bearer shuts down during command execution).

<sent>^(num)

Number of sent packets.

<received>^(num)

Number of received packets.

<lost>^(num)

Number of lost packets.

<lostPercent>^(num)

Lost packets in percent.

<minRTT>^(num)

Minimum Round Trip Time in milliseconds.

Page 290 of 567

10.12 AT^SISE

10.12

AT^SISE Internet Service Error Report

The AT^SISE write command returns the current error status of the specified Internet service profile. If the ser-

vice profile is not defined or the value is invalid "+CME ERROR" response is returned.

The error status is identical to the content of the "^SIS" URC last issued.

If a service fails the commands AT^SISR or AT^SISW will return an error response. However, if the AT^SISE

command returns <infoID>=0 it is recommended to use the AT+CEER command because a general GSM/

GPRS problem might be the reason.

Syntax

Test Command

AT^SISE=?

Response(s)

Write Command

AT^SISE=<srvProfileId>

Response(s)

^SISE: <srvProfileId>, <infoID>[, <info>]

ERROR

+CME ERROR: <err>

PIN ASC0 ASC1

USB MUX1

MUX2

MUX3

Charge

Last

Parameter Description

<srvProfileId>^(num)

Internet service profile identifier as defined by AT^SISS <srvProfileId>.

0...9

<infoID>^(num)

Reason for Internet service error. This is a subset of the <urcInfoId>s which can be found in Section 10.13,

Internet Service URC "^SIS".

The value 0 indicates there is no special Internet service error. In this case the application may use AT+CEER

to check for general GSM/GPRS problems.

<info>^(str)

Information text related to <infoID>. This is a subset of the <urcInfoText>s which can be found in Section

10.13, Internet Service URC "^SIS".

Note

• In particular cases, the AT^SISE command may deliver information and warnings. This applies the following

services:

FTP: Information 2100

POP3: Warnings

SMTP: Warnings

If an error occurs the information and warning messages are overwritten by error messages.

Page 292 of 567

10.13 Internet Service URC "^SIS"

10.13

Internet Service URC "^SIS"

This section first describes the syntax and the parameters of the "^SIS" URC. The second part consists of tables

listing the information elements delivered within the "^SIS" URC and the command response of AT^SISE.

The presentation of the "^SIS" URC containing the parameter <urcCause>=0 can be disabled or enabled

depending on whether polling mode or URC mode is preferred. To do so, use the AT^SCFG command, parameter

"Tcp/WithURCs" (refer to <tcpWithUrc>). However, if related to <urcCause>=1 or 2, the "^SIS" URC will

always be delivered regardless of the setting made with AT^SCFG.

Unsolicited Result Code

Indicates an event, an error or an information element. The same information can be obtained via AT^SISE.

^SIS: <srvProfileId>, <urcCause>[, [<urcInfoId>][, <urcInfoText>]]

The URC may appear if an event or an error occurs, for example after opening an Internet service with AT^SISO

or any time during operation. The URC also indicates a request for a mobile terminated Internet service client

connection, or a failure if a mobile terminated request is rejected. Furthermore, the URC may deliver an informa-

tion element resulting from a specific command given in the service profile.

A list of possible causes can be found in the tables below. The tables contain the <urcInfoId> and, if applica-

ble, a specific <urcInfoText>. If marked with *) the precise text related to a <urcInfoId> varies greatly

depending on the scenario and the implementation of the remote server. In these cases, only a brief explanation

of the scenario can be found in the table column "Description".

Parameter Description

<urcCause>^(num)

URC cause identifier.

An event has occurred after opening or while using an Internet service.

The event number is presented via <urcInfoId> and may be an error, a

warning, an information element or a note. Optionally additional information

may be supplied via <urcInfoText>.

Indicates that an opened Socket listener service is receiving a connection

request from a remote client.

The incoming socket connection is dynamically assigned to the next free Inter-

net service profile. In this case, the parameter <urcInfoId> inside the "^SIS"

URC equals the <srvProfileId> of the dynamically assigned service pro-

file. This ID shall be used to accept the connection request with AT^SISO or to

reject it with AT^SISC.

The connection status may be requested by using the AT^SISI read or write

command or the AT^SISO read command. Among other details, the response

indicates the IP address of the remote client (parameter <remAddr>). This

may be helpful to decide whether to accept or reject the request.

Incoming Socket service client connection has failed. The client request was

rejected automatically because no free Internet service profile was available.

<urcInfoId>^(num)

Information identifier related to <urcCause>. See tables below for further detail. The <urcInfoId> number

ranges indicate the type of information element:

0: Service is working properly.

1 - 2000: Error, service is aborted and enters <srvState>=6 (Down).

2001 - 4000: Information related to progress of service.

4001 - 6000: Warning, but no service abort.

6001 - 8000: Notes

Additional information for Socket service: As stated above, if a Socket connection request from a remote client

is received (see <urcCause>=1) the <urcInfoId> equals the <srvProfileId> of the dynamically assigned

free service profile.

Page 293 of 567

10.13 Internet Service URC "^SIS"

<urcInfoText>^(str)

Information text related to <urcCause>. See tables below for further detail.

10.13.1

Information Elements Related to the Service Application

The following table lists the informatiomation elements which may be returned by all supported services within

the "^SIS" URC and the command response of AT^SISE. It should be noted that TCP/IP socket problems may

occur in all Internet service connections (Socket, FTP, HTTP, POP3 or SMTP).

Description

Information Elements Returned by the TCP/IP socket

Invalid socket descriptor

Socket error

Bad access specified

Socket error

Invalid operation

Socket error

No free socket descriptors

Socket error

The operation would block

Socket error

A previous attempt at this operation is still ongoing

Socket error

Socket is not bound

Socket error

The supplied buffer is too small / large

Socket error

Flags not supported

Socket error

Operation not supported

Socket error

The address is already in use

Socket error

The network is unavailable

Socket error

An established connection was aborted (transmission

Socket error

time-out or protocol error)

Remote host has reset the connection

Socket error

No buffer space available

Socket error

The socket is already connected

Socket error

For TCP/IP sockets, the socket is not connected

Socket error

Socket has been shut down

Socket error

Connection timed out

Socket error

Remote host has rejected the connection

Socket error

Remote host is unreachable

Socket error

An unexpected error occurred

Socket error

Host not found

DNS error

An error occurred that may be transient; a further attempt

DNS error

may succeed.

An unrecoverable error occurred

DNS error

General Information Elements

Fatal: The service has detected an unknown error

Indicates that the remote ser-

vice has closed the connection.

The host shall close the service.

Page 294 of 567

10.13 Internet Service URC "^SIS"

Description

Remote peer has closed the connection

Remote peer has closed the

connection unexpectedly, and

no data are available. The host

shall close the service.

Note that the "^SIS" URC only

indicates the <urcInfoId>,

but the AT^SISE command

indicates both the <urcIn-

foId> and the <urcInfo-

Text>.

Fatal: No memory is available for service action

Fatal: Service has detected an internal error

Connection profile not defined.

PPP LCP FAILED

PPP error

PAP Authentication failed

PPP error

CHAP Authentication failed

PPP error

IPCP failed

PPP error

Warnings

4001

Applies only to interactive text

mode: Indicates that number of

input characters is greater than

<cnfWriteLength>.

General Information Elements

6001

General progress information

for connection setup.

10.13.2

Information Elements Related to FTP Service

Description

100

FTP Server rejects session.

101

FTP Server rejects USER command.

102

FTP Server rejects PASS command.

103

FTP Server rejects PASV command or client can't detect

remote IP address.

104

FTP Server rejects requested client action.

105

The given path segment is wrong.

106

The FTP client requests the file

size from the server before

starting the download. During

transmission phase the client

adds the bytes which are sent

via serial line. After transmis-

sion is done the client com-

pares the amount of bytes

transferred via serial line and

socket.

2100

FILE: <filename>

File name assigned by FTP

server if mode=u is used.

Page 295 of 567

10.13 Internet Service URC "^SIS"

10.13.3

Information Elements Related to HTTP Service

Description

Error URCs

200

HTTP-ERR: Not connected - cannot send request

HTTP-ERR: failed on sending request

201

Client error

202

Server error

HTTP-ERR: Service unavailable

203

HTTP-ERR: Redirect failed - too many redirects

Max. number of allowed redi-

HTTP-ERR: Redirect failed - not allowed

rects: 6

HTTP-ERR: Redirect failed - location missing

204

HTTP-ERR: auth failed - user name or password missing

HTTP-ERR: auth failed - user name or password wrong

HTTP-ERR: Authority required for this URL

HTTP-ERR: No access to this URL allowed

Info URCs

2200

HTTP Redirect to: <Host>:<Port> <Path>

2201

HTTP Response <Response code>

Example: ^SIS: 2,3,2201, "HTTP Response: HTTP/1.1

200 OK"

10.13.4

Information Elements Related to POP3 Service

Description

Errors

300

Indicates that the POP3 User Command could

not be executed successfully.

Warnings

4300

POP3 specific warning

10.13.5

Information Elements Related to SMTP Service

Description

Errors

400

Indicates that the SMTP service could not be

executed successfully.

Warnings

4400

SMTP specific warning

^*) Text varies depending on scenario.

Page 296 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

10.14

Examples of how to Configure and Use Internet Service Profiles

Below you can find selective examples of how to configure and use Internet service profiles. To visualize the dif-

ference between URC mode and polling mode the operation of services (after opening with AT^SISO) is

explained in separate examples for either mode.

10.14.1

Selecting URC Mode or Polling Mode

To enable or disable the presentation of URCs for the Internet services use the AT^SCFG command, type "TcpIp/

WithURCs" and select "on" or "off" for parameter <tcpWithUrc>.

at^scfg=tcp/withurcs

Query the current setting.

^SCFG: "Tcp/WithURCs","on"

URC mode is enabled (delivery detault).

at^scfg=tcp/withurcs,off

Select polling mode (by switching off URC mode).

^SCFG: "Tcp/WithURCs","off"

Polling mode is accepted.

10.14.2

Configuring Socket Listener

The example assumes that a connection profile has been created as explained in Section 10.1.1 or Section

10.1.2. Keep in mind that if the host is configured as listener another service profile must be left free to be dynam-

ically assigned as Server when the listener receives a connection request from a remote client.

Configure the service profile 4 for use as Socket listener:

at^siss=4,srvType,socket

Select service type Socket.

at^siss=4,conId,0

Select connection profile 0.

at^siss=4,address,"socktcp://lis-

The host specifies its local port 65534 to be used for

tener:65534"

the Socket listener service. The local IP address will

be dynamically assigned when the service is opened

with AT^SISO.

Open the Socket service and query the IP address dynamically assigned to the Socket listener:

at^siso=4

Open the Socket service.

at^siso?

Query the current status of services. All service pro-

^SISO: 0, ""

files are unused, except for service profile 4 which is

^SISO: 1, ""

running in listener mode, where <srvState>=3 (lis-

tening) and <socketState>=3 (LISTENER). The

response also indicates the IP address dynamically

assigned to the listener.

^SISO: 2, ""

^SISO: 3, ""

^SISO: 4, "Socket","3","3","0","0","10.10.0.187:65534","0.0.0.0:0"

^SISO: 6, ""

^SISO: 7, ""

^SISO: 8, ""

^SISO: 9, ""

Page 297 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

10.14.3

Configuring Socket Client for Calling a Socket Listener on

Another Host

The example assumes that a connection profile has been created as explained in Section 10.1.1 or Section

10.1.2.

Configure the client's service profile 1 for calling a Socket listener on another host:

at^siss=1,srvType,socket

Select service type Socket.

at^siss=1,conId,0

Select connection profile 0.

at^siss=1,address,"socktcp://

The service profile of the client contains the IP

10.10.0.187:65534"

address and the TCP port of the remote host.

10.14.4

Socket Client Sends Data via TCP Connection (Polling Mode)

The example uses service profile 0 configured for Socket service and TCP.

AT^SISO=0

The host opens service profile 0.

Note: URC ^SISW:0, 1 does not appear! The host

must poll the service state by means of AT^SISI until

the service is in <srvState> "Up".

AT^SISI=0

^SISI: 0,3,0,0,0,0

The service is still in <srvState> "Connecting".

AT^SISI=0

^SISI: 0,4,0,0,0,0

The service is now in <srvState> "Up" and is

ready to accept data.

AT^SISW=0,10

The host requests to write 10 bytes.

^SISW: 0,10,10

Response that 10 bytes can be sent and are unac-

knowledged.

0123456789

AT^SISW=0,10,1

The host requests to write next 10 bytes and enables

the end-of-data flag.

^SISW: 0,0,10

But the service refuses the request, even the end-of-

data flag remains without effect.

AT^SISW=0,10,1

Next try (polling).

^SISW: 0,10,20

Response that the service accepts 10 bytes and this

data and the previously sent data are unacknowl-

edged.

0123456789

AT^SISW=0,0,0

Polling to request unacknowledged data.

^SISW: 0,0,10

There are 10 bytes still unacknowledged.

AT^SISI=0

Polling for

<srvState> change

("Closing"

"Down").

^SISI: 0,5,0,20,10,10

20 bytes are transfered via serial interface, 10 bytes

are acknowledged by remote peer, 10 bytes are on

the way.

Page 298 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

AT^SISI=0

Polling for

<srvState> change

("Closing"

"Down").

^SISI: 0,6,0,20,20,0

The Service is in state "Down" and all data is con-

firmed by the remote peer.

AT^SISC=0

Closing the Socket service.

10.14.5

Socket client sends data via TCP connection with URCs

The example uses service profile 0 configured for Socket service and TCP.

AT^SISO=0

The host opens service profile 0.

^SISW: 0,1

Socket service is ready for upload.

AT^SISW=0,10

The host requests to write 10 bytes.

^SISW: 0,10,10

Response that 10 bytes can be sent and are unac-

knowledged.

0123456789

^SISW: 0,1

The URC indicates that the Socket service is ready

to transfer more data. Data of the last AT^SISW

command are transferred to the remote host.

AT^SISW=0,10,1

The host requests to write next 10 bytes and enables

the end-of-data flag to notify that these are the last

10 bytes of the session.

^SISW: 0,10,20

Response that the service accepts 10 bytes and this

data and the previously sent data are unacknowl-

edged.

0123456789

------

Waiting for URC.

^SISW: 0,2

Data transfer has been finished.

AT^SISC=0

Closing the Socket service.

10.14.6

Configuring and Using FTP Download (URC Mode)

First set up a connection profile as explained in Section 10.1.1 or Section 10.1.2. Enter at least all parameters

which are mandatory for the connection profile.

Configure the service profile 1 for FTP:

at^siss=1,srvType,ftp

Select service type FTP.

at^siss=1,conId,0

Select connection profile 0.

at^siss=1,address,"ftp://

Specify FTP address with user and password anon-

192.168.1.2;type=d"

ymous.

Make an FTP connection:

at^siso=1

Open the service.

Bearer is established, service is getting started.

^SISR: 1, 1

Data is available.

at^sisr=1,1500

Request to read 1500 bytes.

Page 299 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

^SISR: 1, 50

50 bytes are now available.

hardware

inttest

software

support

systemtest

^SISR: 1, 2

Data transfer finished. No more data available. The

connection to the FTP server is closed.

at^sisc=1

Close the service.

10.14.7

Configuring and Using FTP Upload (URC Mode)

First set up a connection profile as explained in Section 10.1.1 or Section 10.1.2. Enter at least all parameters

which are mandatory for the connection profile.

Configure the service profile 1 for FTP:

at^siss=1,srvType,ftp

Select service type FTP.

at^siss=1,conId,0

Select connection profile 0.

at^siss=1,address,"ftpput://

Specify FTP address with individual user name and

myname:mypasswd@192.168.1.2/upload/exam-

password. The file "example.bin" shall be created on

ple.bin;type=i"

the FTP server.

Make an FTP connection:

at^siso=1

Open the service.

Bearer is established, service is getting started.

^SISW: 1, 1

FTP service is ready for upload.

at^sisw=1,100

Client requests to send 100 bytes.

^SISW: 1,100,100

The write command response confirms that 100

bytes must be transferred now.

0123456789012345678901234567890123456789012

User data is transferred.

3456789012345678901234567890123456789012345

67890123456789

^SISW: 1, 1

URC indicates that the FTP service is ready to trans-

fer more data. Data of the last AT^SISW command is

transferred to the remote host.

at^sisw=1,0,1

No more data available. The file "example.bin" shall

be closed on the FTP server.

^SISW: 1, 2

Data transfer finished successfully. The connection

to the FTP server is closed.

at^sisc=1

Close the FTP service.

10.14.8

Configuring SMPT Service Profile

First set up a connection profile as explained in Section 10.1.1 or Section 10.1.2. Enter at least all parameters

which are mandatory for a CSD or GPRS profile. The example uses the connection profile ID 1 and the service

profile ID 9.

at^siss=9,srvType,"Smtp"

Select service type SMTP.

Page 300 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

at^siss=9,alphabet,"1"

Choose ASCII alphabet.

at^siss=9,conId,"1"

Select connection profile 1.

at^siss=9,address,"192.168.1.2"

Specify SMTP server address.

at^siss=9,user,"subscriber1"

Specify sender's user name required for SMTP

authentication.

at^siss=9,passwd,"subscr1"

Specify password used by the sender for SMTP

authentication.

at^siss=9,smFrom,"subscriber1@testdo-

Sender's email address.

main.com"

at^siss=9,smRcpt,"subscriber2@testdo-

Recipient's email address.

main.com"

at^siss=9,smSubj,"Meeting Request Sunday

Enter text for subject field.

Morning"

at^siss=9,smAuth,"1"

Sender name and password can be used for SMTP

authentication.

at^siss?

To check the profile enter the AT^SISS read com-

^SISS: 0, "srvType", ""

mand. The response includes the values of all 10

^SISS: 1, "srvType", ""

connection profiles. In this example, no values are

set for the profiles 0 through 8. Service profile 9 con-

^SISS: 2, "srvType", ""

tains the values specified above and the values auto-

^SISS: 3, "srvType", ""

matically assumed by default.

^SISS: 4, "srvType", ""

^SISS: 6, "srvType", ""

^SISS: 7, "srvType", ""

^SISS: 8, "srvType", ""

^SISS: 9, "srvType", "Smtp"

^SISS: 9, "conId", "1"

^SISS: 9, "alphabet", "1"

^SISS: 9, "address", "192.168.1.2"

^SISS: 9, "user", "subscriber1"

^SISS: 9, "passwd", "*******"

^SISS: 9, "smFrom", "subscriber1@testdomain.com"

^SISS: 9, "smRcpt", "subscriber2@testdomain.com"

^SISS: 9, "smCC", ""

^SISS: 9, "smSubj", "Meeting Request Sunday Morning"

^SISS: 9, "smHdr", ""

^SISS: 9, "tcPort", "25"

Default: TCP port number commonly used for SMTP.

^SISS: 9, "smAuth", "1"

^SISS: 9, "tcpMR", "10"

Default: Number of retransmission attempts for TCP

packets is 10 (= default of AT^SCFG).

^SISS: 9, "tcpOT", "6000"

Default: Timeout before closing outstanding TCP

connection is 6000 sec (= default of AT^SCFG).

10.14.9

Sending Email (URC Mode)

This example uses the service profile described in Section 10.14.8.

at^siso=9

Open the service, i.e. start to send the email.

Page 301 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

^SISW: 9, 1

The "^SISW" URC indicates that email data can be

transferred.

at^sisw=9,87

The email to be sent has 87 bytes.

^SISW: 9,87,87

The write command response confirms that 87 bytes

are available for transmission.

Good Morning everyone, we are delighted to

Write the message text.

announce our next meeting on Sunday morning.

at^sisw=9,0,1

Set the <eodFlag> to mark the end of the email

body.

^SISW: 9,0,0

The <eodFlag> is accepted by the service.

^SISW: 9,2

The "^SISW" URC confirms that all data is sent suc-

cessfully.

at^sisi=9

Check the connection state of the service profile 9.

^SISI: 9,6,0,87,0,0

The command response confirms that the SMTP

service is in state "6" (Down) and that 87 bytes have

been transferred.

at^sisc=9

Close the service.

10.14.10

Sending Email (Polling Mode)

This example uses the service profile described in Section 10.14.8.

at^siso=9

Open the service, i.e. start to send the email.

at^sisw=9,10

Try to write 10 bytes.

^SISW: 9, 10, 0

The service response indicates that 10 bytes can be

written.

Hallo Tom!

Write 10 bytes.

at^sisw=9,10

Try to write 10 bytes.

^SISW: 9, 0, 0

The service response indicates that the service

refuses to accept any data at the moment.

at^sisw0=9,12

Try to write 12 bytes.

^SISW: 9, 12, 0

The service response indicates that 12 bytes can be

written.

Bye Bye Tom!

Write 12 bytes.

at^sisw=9,0,1

Set the <eodFlag> to mark the end of the email

body.

^SISW: 9,0,0

The <eodFlag> is accepted by the service.

at^sisi=9

Check the connection state of service profile 9.

^SISI: 9,5,0,22,0,0

The command response confirms that the SMTP

service is in state "5" (Closing) and that 22 bytes

have been written.

at^sisi=9

Check the connection state of service profile 9.

^SISI: 9,6,0,22,0,0

The command response confirms that the SMTP

service is in state "6" (Down) and that 22 bytes have

been written.

at^sise=9

Check error status of service profile 9.

^SISE: 9,0

The command response confirms that no error

occurred.

Page 302 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

at^sisc=9

Close the service.

10.14.11

Configuring POP3 Service Profile

First set up a connection profile as explained in Section 10.1.1 or Section 10.1.2. Enter at least all parameters

which are mandatory for a GPRS profile. The example uses the connection profile ID 1 and the service profile

ID 1. The service profile is set up to retrieve a specific email (email number 2).

at^siss=1,srvType,"Pop3"

Select service type POP3.

at^siss=1,conId,"1"

Select connection profile 1.

at^siss=1,address,"192.168.1.2"

Specify POP3 server address.

at^siss=1,user,"subscriber1"

Specify recipient's mailbox name.

at^siss=1,passwd,"subscr1"

Password used by recipient for authentication to

POP3 server.

at^siss=1,pCmd,"3"

Command used to retrieve emails.

at^siss=1,pNumber,"2"

Email message number 2 shall be retrieved.

at^siss?

To check the profile enter the AT^SISS read com-

^SISS: 0, "srvType", ""

mand. The response includes the values of all 10

^SISS: 1, "srvType", "Pop3"

connection profiles. Service profile 1 contains the

values specified above and the values automatically

^SISS: 1, "conId", "1"

assumed by default.

^SISS: 1, "alphabet", "0"

Default: Character set enabled with AT+CSCS shall

be used.

^SISS: 1, "address", "192.168.1.2"

^SISS: 1, "user", "subscriber1"

^SISS: 1, "passwd", "*******"

^SISS: 1, "pCmd", "3"

^SISS: 1, "tcPort", "110"

Default: TCP port number commonly used for POP3.

^SISS: 1, "pNumber", "2"

^SISS: 1, "pLength", "0"

Default: Message size shall not be limited.

^SISS: 1, "pDelFlag", "0"

Default: Retrieved message shall not be deleted on

POP3 server.

^SISS: 1, "tcpMR", "10"

Default: Number of retransmission attempts for TCP

packets is 10 (= default of AT^SCFG).

^SISS: 1, "tcpOT", "6000"

Default: Timeout before closing outstanding TCP

connection is 6000 sec (= default of AT^SCFG).

^SISS: 2, "srvType", ""

^SISS: 3, "srvType", ""

^SISS: 4, "srvType", ""

^SISS: 6, "srvType", ""

^SISS: 7, "srvType", ""

^SISS: 8, "srvType", ""

^SISS: 9, "srvType", ""

10.14.12

Retrieving Email (URC Mode)

This example uses the service profile described in Section 10.14.11.

Page 303 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

at^siso=1

Open the service that was created to retrieve email

number 2 from the POP3 server.

^SISR: 1, 1

The "^SISR" indicates that data is available for read-

ing.

at^sisr=1,500

Try to read 500 bytes.

^SISR: 1, 500

Command response indicates that 500 bytes will be

transferred, i.e. there will be no other URC since the

requested length equals the confirmed length.

Return-Path: <subscriber1@testdomain.com>

X-Original-To: subscriber1@testdomain.com

Delivered-To: subscriber2@testdomain.com

Received: from 10.10.0.132 (unknown [10.10.0.132])

by testdomain.com (Postfix) with SMTP id 379321D004

for <subscriber1@testdomain.com>; Tue, 20 Dec 2005 08:00:07 +0100 (CET)

To: subscriber2@testdomain.com

Cc:

From: subscriber1@testdomain.com

Subject: TestMail

Message-Id: <20051220070007.379321D004@testdomain.com >

Date: Tue, 20 Dec 2005 08:00:07 +0100

at^sisr=1,500

Try to read another 500 bytes.

at^sisr=1,78

Command response indicates that only 78 bytes will

transferred.

(CET)

X-UIDL: &lL"!(Z6"!^cl!!1+%"!

Status: RO

Hallo Tom!Bye Bye Tom!

Dot indicates end of mail according to RFC 2821.

^SISR: 1, 2

Parameter <urcCauseId> of the "^SISR" URC

confirms that all data is transferred successfully.

at^sisc=1

Close the service.

10.14.13

Retrieving Email (Polling Mode)

This example uses the service profile described in Section 10.14.11.

at^siso=1

Open the service that was created to retrieve email

number 2 from the POP3 server.

at^sisr=1,1000

Try to read 1000 bytes.

^SISR: 1, 0

Command response indicates that currently no data

is available.

at^sisr=1,1000

Again, try to read 1000 bytes.

^SISR: 1, 0

Command response indicates that currently no data

is available.

at^sisr=1,1000

Again, try to read 1000 bytes.

^SISR: 1, 578

Command response indicates that 578 bytes are

available for reading.

Page 304 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

Return-Path: <subscriber1@testdomain.com>

X-Original-To: subscriber1@testdomain.com

Delivered-To: subscriber2@testdomain.com

Received: from 10.10.0.132 (unknown [10.10.0.132])

by testdomain.com (Postfix) with SMTP id 379321D004

for <subscriber1@testdomain.com>; Tue, 20 Dec 2005 08:00:07 +0100 (CET)

To: subscriber2@testdomain.com

Cc:

From: subscriber1@testdomain.com

Subject: TestMail

Message-Id: <20051220070007.379321D004@testdomain.com >

Date: Tue, 20 Dec 2005 08:00:07 +0100 (CET)

X-UIDL: &lL"!(Z6"!^cl!!1+%"!

Status: RO

Hallo Tom!Bye Bye Tom!

Dot indicates end of mail according to RFC 2821.

at^sisr=1,1000

Try to read 1000 bytes once again.

^SISR: 1,-2

No more data available to read, i.e. the service has

finished.

at^sisi=1

Check the connection state of service profile 1.

^SISI: 1,6,578,0,0,0

The command response indicates that the POP3

service is in state "6" (Down) and that 578 bytes have

been retrieved.

at^sise=1

Check error status of service profile 1.

^SISE: 1,0

The command response confirms that no error

occurred.

at^sisc=1

Close the service.

10.14.14

HTTP POST (Polling Mode)

at^siss=1,srvType,"Http"

Select service type HTTP.

at^siss=1,conId,1

Select connection profile 1.

at^siss=1,hcMethod,1

Select "Post" method.

at^siss=1,address,"http://192.168.1.3/datafiles/dummy/dummy.txt"

at^siss=1,hcContLen,180

Try to upload 180 bytes.

at^siso=1

Open the service.

at^sisw=1,100

Send the first 100 bytes.

^SISW: 1, 100, 0

at^sisw=1,100

Try to send again 100 bytes.

^SISW: 1, 80, 0

80 bytes are sent.

at^sisw=1,40

Try to write data once again.

^SISW: 1, 0, 0

No further data available, i.e. the service has fin-

ished.

Page 305 of 567

10.14 Examples of how to Configure and Use Internet Service Profiles

at^sisi?

^SISI: 1,6,0,180,0,0

The command response indicates that HTTP service

is in state "6" (Down) and that 180 bytes have been

sent.

at^sise=1

Check error status of service profile 1.

^SISE: 1,0

The command response confirms that no error

occurred.

at^sisc=1

Close the service.

10.14.15

HTTP GET (Polling Mode)

at^siss=0,srvType,"Http"

Select service type HTTP.

at^siss=0,conId,1

Select connection profile 1.

at^siss=0,hcMethod,0

at^siss=0,address,http://192.168.1.4/

at^siso=0

at^sisr=0,1500

Start reading data in polling mode.

^SISR: 0, 1264

...DATA...

at^sisr=0,1500

^SISR: 0, 1500

...DATA...

at^sisr=0,1500

^SISR: 0, 602

...DATA...

at^sisr=0,1500

Again, try to read 1500 bytes.

^SISR: 0, -2

Nor more data to read, i.e. the service has finished.

at^sisi?

^SISI: 0,6,0,3366,0,0

The command response indicates that the HTTP

service is in state "6" (Down) and that 3366 bytes

have been read.

at^sise=0

Check error status of service profile 0.

^SISE: 0,0

The command response confirms that no error

occurred.

at^sisc=0

Close the service.

Page 306 of 567

11. GPRS Commands

11.

GPRS Commands

This chapter describes AT Commands that a TE (Terminal Equipment, e.g. an application running on a control-

ling PC) may use to control the TC65 acting as GPRS Mobile Termination (MT). Please use chapter "Using

GPRS AT commands (Examples)" as a first guidance.

11.1

AT+CGACT PDP context activate or deactivate

Syntax

Test Command

AT+CGACT=?

Response(s)

+CGACT: (list of supported <state>s)

Read Command

AT+CGACT?

Response(s)

+CGACT: <cid>, <state>

[+CGACT: <cid>, <state>]

Write Command

AT+CGACT=[<state>[, <cid>[, <cid>]]]

Response(s)

ERROR

+CME ERROR

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Command Description

The test command is used for requesting information on the supported PDP context activation states.

The read command returns the current activation states for all the defined PDP contexts.

The write command is used to activate or deactivate the specified PDP context(s). After the command has com-

pleted, the MT remains in V.250 command state. If any PDP context is already in the requested state, the state

for that context remains unchanged. If the MT is not GPRS attached when the activation form of the command

is executed, the MT first performs a GPRS attach and then attempts to activate the specified contexts. If no

<cid>s are specified the activation/deactivation form of the command activates/deactivates all defined contexts.

Parameter Description

<state>^(num)

Indicates the state of PDP context activation.

deactivated

[1]

activated

Page 307 of 567

11.1 AT+CGACT

<cid>^(num)

PDP Context Identifier is a numeric parameter which specifies a particular PDP context definition. The param-

eter is local to the TE-MT interface and is used in other PDP context related commands.

1...2

Notes

• ATH will deactivate any PDP context.

• If the MT is in dedicated mode, the write command returns "+CME ERROR: operation temporary not allowed".

• A maximum of 2 contexts can be activated at the same time, no matter on which interface. Trying to activate

more than 2 contexts will cause "+CME ERROR: operation temporary not allowed". Note that, depending on

the provider, the number of activated contexts may be further restricted.

Remember that contexts may be activated implicitly by using the ATD*98# or ATD*99# GPRS compatibility

commands without specifying a <cid>.

• If an activated context will be deactivated without using the command AT+CGACT, then the result code "NO

CARRIER" will be issued to indicate the context deactivation. This happens for example if the context deac-

tivation is forced by the network or if deactivation results from a network deregistration with AT+COPS=2.

Page 308 of 567

11.2 AT+CGANS

11.2

AT+CGANS Manual response to a network request for PDP con-

text activation

Syntax

Test Command

AT+CGANS=?

Response(s)

+CGANS: (list of supported <response>s), (list of supported <L2P>s)

Write Command

AT+CGANS=[<response>[, <L2P>[, <cid>]]]

Response(s)

CONNECT

NO CARRIER

ERROR

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

GSM 07.07

Command Description

The write command requests the MT to respond to a network request for GPRS PDP context activation which

has been signaled to the TE by the RING or CRING unsolicited result code. The <response> parameter allows

the TE to accept or reject the request.

Parameter Description

<response>^(num)

[0]

the request is rejected and the MT returns OK to the TE

accept and request that the PDP context be activated

<L2P>^(str)

a string parameter which indicates the layer 2 protocol to be used (see AT+CGDATA command)

<cid>^(num)

a numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command).

Note

• If <response> is 1, the following procedure is followed by the MT:

If the <L2P> parameter value is unacceptable to the MT, the MT will return an ERROR or +CME ERROR

response. Otherwise, the MT issues the intermediate result code CONNECT and enters V.250 online data

state.

A <cid> may be specified for use in the context activation request.

During the PDP startup procedure the MT has the PDP type and the PDP address provided by the network

in the Request PDP context activation message. If this is in conflict with the information provided by a spec-

ified <cid>, the command will fail. There will be no conflict, if the PDP type matches exactly and the PDP

address given by the context definition for <cid> is empty or matches exactly with the address specified with

the network PDP context activation message.

The context will be activated using the values for PDP type and address provided by the network, together

with all other information found in the PDP context definition. An APN may or may not be required, depending

on the application.

Page 309 of 567

11.2 AT+CGANS

If no <cid> is given or if there is no matching context definition, the MT will attempt to activate the context

using the values for PDP type and address provided by the network. The other parameters will be set to their

default values (see AT+CGDCONT).

If activation is successful, data transfer may proceed.

After data transfer is complete, and the layer 2 protocol termination procedure has completed successfully,

the V.250 command state is reentered and the MT returns the final result code OK.

In the event of an erroneous termination or a failure to start up, the V.250 command state is re-entered and

the MT returns the final result code NO CARRIER, or if enabled, +CME ERROR. Attach, activate and other

errors may be reported. It is also an error to issue the AT+CGANS command when there is no pending network

request.

The command may be used in both normal and modem compatibility modes.

Page 310 of 567

11.3 AT+CGATT

11.3

AT+CGATT GPRS attach or detach

Syntax

Test Command

AT+CGATT=?

Response(s)

+CGATT: (list of supported <state>s)

Read Command

AT+CGATT?

Response(s)

+CGATT: <state>

Write Command

AT+CGATT=[<state>]

Response(s)

ERROR

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Command Description

The test command is used for requesting information on the supported GPRS service states.

The read command returns the current GPRS service state.

The write command is used to attach the MT to, or detach the MT from the GPRS service. After the command

has completed, the MT remains in V.250 command state. If the MT is already in the requested state, the com-

mand is ignored and the OK response is returned. Any active PDP contexts will be automatically deactivated

when the attachment state changes to detached.

Parameter Description

<state>^(num)

Indicates the state of GPRS attachement.

0^(P)

detached

[1]

attached

Notes

• If the MT is in dedicated mode, write command returns "+CME ERROR: operation temporary not allowed".

• When the module is GPRS attached and a PLMN reselection occurs to a non-GPRS network or to a network

where the SIM is not subscribed to for using GPRS, the resulting GMM (GPRS mobility management) state

according to GSM 24.008 is REGISTERED/NO CELL, meaning that the read command will still show

<state>=1.

Page 311 of 567

11.4 AT+CGAUTO

11.4

AT+CGAUTO Automatic response to a network request for PDP

context activation

Syntax

Test Command

AT+CGAUTO=?

Response(s)

+CGAUTO: (list of supported <n>s)

Read Command

AT+CGAUTO?

Response(s)

+CGAUTO: <n>

Write Command

AT+CGAUTO=[<n>]

Response(s)

ERROR

+CME ERROR

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Command Description

The test command returns the values of <n> supported by the MT as a compound value.

The write command disables or enables an automatic positive response (auto-answer) to the receipt of a

Request PDP Context Activation message from the network. It also provides control over the use of the V.250

basic commands ATS0, ATA and ATH for handling network requests for PDP context activation.

Parameter Description

<n>^(num)

Disable automatic response for network requests for GPRS PDP context acti-

vation. GPRS network requests are manually accepted or rejected by the

AT+CGANS command.

Enable automatic response for network requests for GPRS PDP context acti-

vation. GPRS requests are automatically accepted according to the description

below.

3^(&F)(P)

Modem compatibility mode. The automatic acceptance of both GPRS and

incoming CSD calls is controlled by the ATS0 command. Manual control uses

the ATA and ATH commands, respectively, to accept or reject GPRS network

requests or incoming CSD calls.

Notes

• It is allowed to have different AT+CGAUTO settings on different interfaces.

• When the AT+CGAUTO=0 command is received, the MT will not perform a GPRS detach if it is attached. Sub-

sequently, when the MT announces a network request for PDP context activation by issuing the URC RING

or CRING, the TE may manually accept or reject the request by issuing the AT+CGANS command or may sim-

ply ignore the network request.

Page 312 of 567

11.4 AT+CGAUTO

• When the AT+CGAUTO=1 command is received, the MT will attempt to perform a GPRS attach if it is not yet

attached. Failure will result in ERROR or, if enabled +CME ERROR being returned to the TE. Subsequently,

the MT announces a network request for PDP context activation by issuing the URC RING to the TE, followed

by the intermediate result code CONNECT. The MT then enters V.250 online data state and follows the same

procedure as it would after having received a +CGANS=1 with no <L2P> or <cid> values specified.

• If a GPRS attach will be initiated by this command and the MT is not able to attach for more than 385 seconds

(timer T3310 expired), command returns with "ERROR" or "+CME ERROR: unknown", but MT is still trying

to attach and the requested automatic mode <n> is in use.

• If a network request for PDP context activation is answered automatically and if another AT command is

issued at the same time on the same interface, then this AT command is not executed. Any response belongs

to the automatic context activation procedure. If the AT command which caused the collision was a circuit

switched data call, the CONNECT response does not belong to this data call but to the GPRS. This can be

detected if ATX is not set to 0. CS data call will issue CONNECT <text>, GPRS will issue CONNECT only.

Page 313 of 567

11.5 AT+CGDATA

11.5

AT+CGDATA Enter data state

Syntax

Test Command

AT+CGDATA=?

Response(s)

+CGDATA: (list of supported <L2P>s)

Write Command

AT+CGDATA=[<L2P>[, <cid>[, <cid>]]]

Response(s)

CONNECT

NO CARRIER

ERROR

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

GSM 07.07

Command Description

The test command is used for requesting information on the supported layer 2 protocols to be used between the

TE and MT.

The write command causes the MT to perform all actions which arenecessary to establish communication

between the TE and the network using one or more GPRS PDP types. This may include performing a GPRS

attach and one or more PDP context activations. Commands following the AT+CGDATA command in the AT com-

mand line will not be processed by the MT.

If no <cid> is given or if there is no matching context definition, the MT will attempt to activate the context with

PDP type IP and all other context parameters set to their default values (see AT+CGDCONT, AT+CGQREQ,

AT+CGQMIN).

If the <L2P> parameter is omitted, the layer 2 protocol is unspecified and PPP will be used.

If the write command is successful, the MT issues the intermediate result code CONNECT and enters V.250

online data state.

After data transfer is complete, and the layer 2 protocol termination procedure has completed successfully, the

command state is reentered and the MT returns the final result code OK.

If the <L2P> parameter value is unacceptable to the MT, the MT returns ERROR or +CME ERROR.

In the event of erroneous termination or a failure to start up, the command state is reentered and the MT returns

NO CARRIER, or if enabled +CME ERROR.

Parameter Description

<L2P>^(str)

Layer 2 protocol to be used between the TE and MT.

["PPP"]

layer 2 protocol PPP

<cid>^(num)

Parameter specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is

used in other PDP context-related commands.

1...2

Page 314 of 567

11.5 AT+CGDATA

Notes

• If the MT is in dedicated mode, write command returns "+CME ERROR: operation temporary not allowed".

• It is possible to leave the GPRS data mode and enter the command mode by using the V.250 command +++.

By using the command AT+CGDATA again, the data mode is reentered. Which context is used to return to

data mode, depends on the supplied parameter <cid>.

If no <cid> is specified, this is equivalent to using the V.250 command ATO, which is usable for GPRS con-

nections too. In this case the first context will be used, which is active and already in data mode since it has

been activated.

It is possible to use AT+CGDATA to enter the data mode for a context, which is not yet in data mode since it

has been activated. With ATO this is not possible.

11.5.1

Automatic deactivation of PDP context during dial-up PPP

When using the AT+CGDATA write command or ATD*99# or ATD*98# the MT issues the intermediate result

code CONNECT and enters V.250ter online data state. In V.250 online data state, first some LCP protocol

exchange between MT and TE is performed to set up the PPP link. After successfully establishing the PPP link,

the MT performs the PDP context activation procedure if the context is not already activated. As a result, the MT

is in a "PDP context activated" state within the PLMN, the PPP link is established on the mobile side and the

mobile is ready for IP data transfer.

If the TE wants to close the LCP link the MT may perform an LCP termination request procedure on PPP level.

After this LCP termination procedure the MT deactivates the PDP context automatically and the MT returns to

V.250 command mode and issues the final result code NO CARRIER.

During the implicit PDP context deactivation procedure after LCP termination the TE may change into V.250

command state (e.g. by using +++ or by toggling DTR if AT&D is set to 1) before the result NO CARRIER occurs.

In this case the application should not try to deactivate the PDP context by using the commands AT+CGACT or

ATH. If DTR is configured to disconnect data connections (AT&D2), then the application should not toggle DTR

during the implicit PDP context deactivation and before "NO CARRIER" is received.

Page 315 of 567

11.6 AT+CGDCONT

11.6

AT+CGDCONT Define PDP Context

Syntax

Test Command

AT+CGDCONT=?

Response(s)

+CGDCONT: (range of supported<cid>s), <PDP_type>, , , (list of supported <d_comp>s), (list of supported

<h_comp>s)

ERROR

+CME ERROR

Read Command

AT+CGDCONT?

Response(s)

[+CGDCONT: <cid>, <PDP_type>, <APN>, <PDP_addr>, <d_comp>, <h_comp>]

[+CGDCONT: ...]

ERROR

+CME ERROR

Write Command

AT+CGDCONT=[<cid>[, <PDP_type>[, <APN>[, <PDP_addr>[, <d_comp>[, <h_comp>]]]]]]

Response(s)

ERROR

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3

Charge

Last

GSM 07.07

Command Description

The test command returns supported values as a compound value.

The read command returns the current settings for each defined PDP context.

The write command specifies the parameters for a PDP context identified by the context identifier <cid>. The

number of contexts that may be in a defined state at the same time is given by the range returned by the test

command. A special form of the write command (AT+CGDCONT=<cid>) causes the values for context <cid> to

become undefined.

Parameter Description

<cid>^(num)

PDP Context Identifier

Parameter specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is

used in other PDP context-related commands.

1...2

<PDP_type>^(str)

Packet Data Protocol type

Specifies the type of the packet data protocol.

"IP"

Internet Protocol (IETF STD 5)

Page 316 of 567

11.6 AT+CGDCONT

<APN>^(str)

Access Point Name

The logical name that is used to select the GGSN or the external packet data network. If the value is null or

omitted, then the subscription value will be requested.

<PDP_addr>^(str)

Packet Data Protocol address

Identifies the MT in the address space applicable to PDP (e.g. IP V4 address for PDP type IP). If the value is

null or omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a

dynamic address will be requested.

<d_comp>^(num)

Data Compression

Controls the PDP data compression (applicable for Subnetwork Dependent Convergence Protocol (SNDCP)

only) 3GPP TS 44.065

[0]

off

<h_comp>^(num)

Header Compression

Controls the PDP header compression 3GPP TS 44.065, 3GPP TS 25.323

[0]

off

Notes

• The MT supports PDP type IP only.

• All context definitions will be stored non volatile if the ME is configured accordingly (see AT^SCFG parameter

"GPRS/PersistentContexts" (<gpc>)).

• If the non volatile storage of CGDCONT settings is not activated by the AT^SCFG parameter "GPRS/Persis-

tentContexts", then AT&F and ATZ will undefine every context which is not active or not online.

Page 317 of 567

11.7 AT+CGEQMIN

11.7

AT+CGEQMIN 3G Quality of Service Profile (Minimum accept-

able)

Syntax

Test Command

AT+CGEQMIN=?

Response(s)

+CGEQMIN: <PDP_type>, (list of supported <Traffic class>s), (list of supported <Maximum bitrate

UL>s), (list of supported <Maximum bitrate DL>s), (list of supported <Guaranteed bitrate UL>s),

(list of supported <Guaranteed bitrate DL>s), (list of supported <Delivery order>s), (list of

supported <Maximum SDU size>s), (list of supported <SDU error ratio>s), (list of supported

<Residual bit error ratio>s), (list of supported <Delivery of erroneous SDUs>s), (list of

supported <Transfer delay>s), (list of supported <Traffic handling priority>s)

Read Command

AT+CGEQMIN?

Response(s)

[+CGEQMIN: <cid>, <Traffic class>, <Maximum bitrate UL>, <Maximum bitrate DL>,

<Guaranteed bitrate UL>, <Guaranteed bitrate DL>, <Delivery order>, <Maximum SDU

size>, <SDU error ratio>, <Residual bit error ratio>, <Delivery of erroneous SDUs>,

<Transfer delay>, <Traffic handling priority>]

[+CGEQMIN: ...]

Write Command

AT+CGEQMIN=[<cid>[, <Traffic class>[, <Maximum bitrate UL>[, <Maximum bitrate DL>[,

<Guaranteed bitrate UL>[, <Guaranteed bitrate DL>[, <Delivery order>[, <Maximum SDU

size>[, <SDU error ratio>[, <Residual bit error ratio>[, <Delivery of erroneous

SDUs>[, <Transfer delay>[, <Traffic handling priority>]]]]]]]]]]]]]

Response(s)

ERROR

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

3GPP TS 27.007

Command Description

The test command returns values supported as a compound value.

The read command returns the current settings for each defined context.

The write command allows the TE to specify a Quality of Service Profile for the context identified by the (local)

context identification parameter <cid> which is checked by the MT against the negotiated profile returned in the

Activate/Modify PDP Context Accept message.

A special form of the write command, AT+CGEQMIN=<cid> causes the requested profile for context number

<cid> to become undefined.

AT&F and ATZ will undefine the QoS profiles of every context which is not active or not online.

Parameter Description

<cid>^(num)

Parameter specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is

used in other PDP context-related commands.

1...2

Page 318 of 567

11.7 AT+CGEQMIN

<Traffic class>^(num)

conversational

streaming

interactive

background

[4]

subscribed value

<Maximum bitrate UL>^(num)

This parameter indicates the maximum number of kbits/s delivered to UMTS (up-link traffic) at a SAP. As an

example a bitrate of 32kbit/s would be specified as 32 (e.g. AT+CGEQMIN=...,32,...).

[0]

subscribed value

1...63

64...128

(value needs to be divisible by 8 without remainder)

256

512

<Maximum bitrate DL>^(num)

This parameter indicates the maximum number of kbits/s delivered by UMTS (down-link traffic) at a SAP. As an

example a bitrate of 32kbit/s would be specified as 32 (e.g. AT+CGEQMIN=...,32,...).

[0]

subscribed value

1...63

64...256

(value needs to be divisible by 8 without remainder)

512

<Guaranteed bitrate UL>^(num)

This parameter indicates the guaranteed number of kbits/s delivered to UMTS (up-link traffic) at a SAP (provided

that there is data to deliver). As an example a bitrate of

32kbit/s would be specified as

32 (e.g.

AT+CGEQMIN=...,32,...).

[0]

subscribed value

1...63

64...128

(value needs to be divisible by 8 without remainder)

<Guaranteed bitrate DL>^(num)

This parameter indicates the guaranteed number of kbits/s delivered by UMTS (down-link traffic) at a SAP (pro-

vided that there is data to deliver). As an example a bitrate of 32kbit/s would be specified as 32 (e.g.

AT+CGEQMIN=...,32,...).

[0]

subscribed value

1...63

64...256

(value needs to be divisible by 8 without remainder)

<Delivery order>^(num)

This parameter indicates whether the UMTS bearer shall provide in-sequence SDU delivery or not.

yes

[2]

subscribed value

Page 319 of 567

Siemens TC65 Terminal. Manual (Version: 02.000) - part 4