AT Commands Examples

locate, communicate, accelerate

Examples for
u-blox wireless modules
Application Note

Abstract
This document provides detailed examples of how to use AT
commands with u-blox wireless modules.

www.u-blox.com
 AT Commands Examples - Application Note

Document Information
Title AT Commands Examples
Examples for
Subtitle
u-blox wireless modules
Document type Application Note
Document number GSM.G1-CS-09003-C1
Document status Preliminary

Document status information

Objective This document contains target values. Revised and supplementary data will be published
Specification later.
Advance This document contains data based on early testing. Revised and supplementary data will
Information be published later.
Preliminary This document contains data from product verification. Revised and supplementary data
may be published later.
Released This document contains the final product specification.

This document and the use of any information contained therein, is subject to the acceptance of the u-blox terms and conditions. They
can be downloaded from www.u-blox.com.
u-blox makes no warranties based on the accuracy or completeness of the contents of this document and reserves the right to make
changes to specifications and product descriptions at any time without notice.
u-blox reserves all rights to this document and the information contained herein. Reproduction, use or disclosure to third parties without
express permission is strictly prohibited. Copyright © 2010, u-blox AG.

GSM.G1-CS-09003-C1 Page 2 of 39
 AT Commands Examples - Application Note

Contents
Contents.............................................................................................................................. 3

1 Introduction .................................................................................................................. 5

2 Storing parameters ...................................................................................................... 5

3 Network registration and configuration .................................................................... 6

3.1 Steps performed to register the module to a GSM/UMTS network ........................................................ 6
3.1.1 Preliminary operations ................................................................................................................... 6
3.1.2 Network registration: GSM module ............................................................................................... 6
3.1.3 Network registration: UMTS module ............................................................................................. 7

4 GPRS connection......................................................................................................... 10
4.1 Context Activation .............................................................................................................................. 10
4.2 Context Deactivation .......................................................................................................................... 11
4.2.1 Context Deactivation by the network .......................................................................................... 11
4.2.1 Context Deactivation by the module ........................................................................................... 11

5 TCP/IP AT Commands ................................................................................................. 11

5.1 Socket Connect .................................................................................................................................. 11
5.2 Socket Listening.................................................................................................................................. 12
5.3 Socket Write ....................................................................................................................................... 12
5.3.1 Binary mode ................................................................................................................................ 12
5.3.2 Base syntax.................................................................................................................................. 13
5.3.3 Queue FULL ................................................................................................................................. 13
5.3.4 GSM network coverage lost ........................................................................................................ 14
5.4 Socket operations with “KEEP ALIVE” option ..................................................................................... 16
5.5 Socket Read........................................................................................................................................ 16
5.6 Socket State ....................................................................................................................................... 18
5.7 Socket Close ....................................................................................................................................... 19
5.8 Direct Link .......................................................................................................................................... 19
5.8.1 Enter and exit from Direct Link Mode .......................................................................................... 19
5.8.2 Closing a connection ................................................................................................................... 20
5.8.3 Connection closed by remote host .............................................................................................. 21

6 UDP/IP AT Commands ................................................................................................ 21

6.1 Socket Write (+USOST) ....................................................................................................................... 21
6.2 Socket Read (+USORF) ........................................................................................................................ 22
6.3 Socket Write (+USOWR) ..................................................................................................................... 23
6.4 Socket Read (+USORD) ....................................................................................................................... 24

7 FTP AT Commands ...................................................................................................... 24

GSM.G1-CS-09003-C1 Preliminary Page 3 of 39

 AT Commands Examples - Application Note

7.1 Direct Link .......................................................................................................................................... 26

7.1.1 Retrieve a file from FTP server ...................................................................................................... 26
7.1.2 Aborting retrieve file request ....................................................................................................... 27
7.1.3 Store a file on FTP server ............................................................................................................. 27
7.1.4 About “+++” escape sequence usage ......................................................................................... 28

8 SMTP AT Commands .................................................................................................. 28

9 HTTP AT Commands ................................................................................................... 29

10 GPS AT Commands ..................................................................................................... 30

10.1 Using GPS without aiding support .................................................................................................. 30
10.2 Using GPS with local aiding support ................................................................................................ 31
10.3 Using GPS with AssistNow Offline support ...................................................................................... 31
10.4 Using GPS with AssistNow Online support ...................................................................................... 31
10.5 Additional GPS AT commands ......................................................................................................... 32

11 Network Congestion Detection AT Commands ....................................................... 33

11.1 GSM module................................................................................................................................... 33
11.2 UMTS module ................................................................................................................................. 33
11.2.1 2G congestion detection ............................................................................................................. 33
11.2.2 3G congestion detection ............................................................................................................. 33
11.2.3 2G and 3G congestion detection ................................................................................................. 33

12 ADC AT Commands (if supported) ............................................................................ 34

13 GPIO AT Commands ................................................................................................... 34

14 MUX AT Commands ................................................................................................... 34

15 File System AT commands ......................................................................................... 35

Appendix .......................................................................................................................... 36

A List of Acronyms ......................................................................................................... 36

Related documents........................................................................................................... 38

Revision history ................................................................................................................ 38

Contact .............................................................................................................................. 39

GSM.G1-CS-09003-C1 Preliminary Page 4 of 39

 AT Commands Examples - Application Note

1 Introduction
This document provides examples of using AT commands. For more details on AT command description please
refer to u-blox 2G GSM/GPRS AT Commands Manual [1] or u-blox 3.5G HSDPA AT Commands Manual [4].

2 Storing parameters
Save parameters in the Non Volatile Memory (NVM). Retrieve parameters from NVM. For further details refer to
the command description of AT+CPWROFF, AT&V, AT&W, ATY in the u-blox 2G GSM/GPRS AT Commands
Manual [1] or u-blox 3.5G HSDPA AT Commands Manual [4].

Command Response Description

AT+CMEE=2 OK Set verbose error messages.
AT&K3 OK Enable RTS/CTS DTE flow control for the current
profile.

NOTE: this is the default value saved in profiles 0 and

1. If no changes have been previously done to
AT&K values in the stored profiles this step is
not mandatory.
AT&Y1 OK Select the default profile that will be automatically
loaded after the next hardware reset (in this example
profile #1).
AT&W1 OK Store the current settings into profile 1.
AT&V ACTIVE PROFILE: Display both the current profile and the user profiles
&C1, &D1, &S1, &K3, E1, Q0, stored in memory.
V1, X4, S00:000, S02:043,
S03:013, S04:010, S05:008, NOTE: this example refers to 3G modules, different
S07:255, +CBST:007, 000, 001, values will be shown on 2G modules
+CRLP:061, 061, 048, 006,
+CR:000, +CRC:000,
+IPR:115200,
+COPS:0,0,FFFFF, +ICF:3,1,
+UPSV: 0, +CMGF:0,
+CNMI:1,0,0,0,0

STORED PROFILE 0:
&C1, &D1, &S1, &K3, E1, Q0,
V1, X4, S00:000, S02:043,
S03:013, S04:010, S05:008,
S07:255, +CBST:007, 000, 001,
+CRLP:061, 061, 048, 006,
+CR:000, +CRC:000,
+IPR:115200,
+COPS:0,0,FFFFF, +ICF:3,1,
+UPSV: 0, +CMGF:0,
+CNMI:1,0,0,0,0

STORED PROFILE 1:
&C1, &D1, &S1, &K3, E1, Q0,
V1, X4, S00:000, S02:043,
S03:013, S04:010, S05:008,
S07:255, +CBST:007, 000, 001,
+CRLP:061, 061, 048, 006,
+CR:000, +CRC:000,
+IPR:115200,
+COPS:0,0,FFFFF, +ICF:3,1,
+UPSV: 0, +CMGF:0,
+CNMI:1,0,0,0,0

OK

GSM.G1-CS-09003-C1 Preliminary Page 5 of 39

 AT Commands Examples - Application Note

Command Response Description

AT+CPWROFF OK To save the stored configuration it is needed to switch
off the module.
AT+CFUN=15 OK To save the stored configuration and reboot the
module without needing to switch the module off
and back on.

3 Network registration and configuration

3.1 Steps performed to register the module to a GSM/UMTS network
The following steps are necessary to register the module on a GSM/UMTS network:
1. Set verbose error messages
2. Check the PIN
3. Check network registration status

3.1.1 Preliminary operations

Command Response Description

AT+CMEE=2 OK Set verbose error messages.
Note: This step is not mandatory.
AT+CPIN? +CPIN: SIM PIN Check the PIN.
OK
AT+CPIN="1234" OK Define PIN.
AT+CPIN? +CPIN: READY Check PIN.
Note: OK, the PIN is ready.
OK

3.1.2 Network registration: GSM module

3.1.2.1 Check network registration (first scenario)

Command Response Description

AT+COPS? +COPS: 0,0,"vodafone IT" Check network registration status.
Note: OK, the module is registered to GSM service.
OK
AT+CGATT? +CGATT: 1 Check GPRS attach status.
Note: OK, the module is GPRS attached.
OK

3.1.2.2 Check network registration (second scenario)

Command Response Description

AT+COPS? +COPS: 2 Check network registration status.
Note: OK, the module is not registered to GSM
OK service.
AT+COPS=0 OK Force network registration.

GSM.G1-CS-09003-C1 Preliminary Page 6 of 39

 AT Commands Examples - Application Note

Command Response Description

AT+COPS? +COPS: 0,0,"vodafone IT" Check network registration status.
Note: OK, the module is registered to GSM service.
OK

3.1.3 Network registration: UMTS module

3.1.3.1 Preliminary information about Radio Access Technology (RAT) configuration

Default RAT configuration is GSM / UMTS Dual Mode with UMTS preferred access technology.

Command Response Description

AT+URAT? +URAT: 1,2 The Default RAT configuration is GSM / UMTS Dual
mode Radio Access technology with UMTS preferred
OK access technology. With this configuration the module
can access both GSM and UMTS networks, UMTS
networks are preferred.

Any change in the RAT selection has to be done when the module is deregistered from the network.
Before changing the RAT deregister the module with AT+COPS=2 command.
After changing the RAT configuration to ensure that the new settings are saved in the NVM it’s
necessary to power off the module (AT+CPWROFF). Then switch on the module and repeat the steps
listed in chapter 3.1.1.
When a new RAT setting is saved in the NVM it’s not possible to load the RAT factory defined
configuration. You can restore this by performing the following steps:

Command Response Description

AT+COPS=2 OK Deregister the module from the network. This
operation must only be performed if the module is
registered on the network.
AT+URAT=1,2 OK Select GSM / UMTS Dual mode Radio Access
technology with UMTS networks preferred.
This is the RAT factory defined configuration.
AT+CPWROFF OK Switch off the module.

3.1.3.2 Selection of Radio Access technology

GSM Single Mode Radio Access technology

Command Response Description

AT+URAT=0,0 OK Select GSM Single Mode Radio Access technology.
AT+URAT? +URAT: 0,0 With this configuration the module can access only
GSM networks.
OK
AT+COPS=0 OK Start automatic network registration.
AT+COPS? +COPS: 0,0,"vodafone IT",0 Check network registration status.
Last parameter (0 in this case) indicates the module is
OK registered to GSM service (as expected considering
that module is not allowed to access to UMTS
networks).

GSM.G1-CS-09003-C1 Preliminary Page 7 of 39

 AT Commands Examples - Application Note

GSM / UMTS Dual mode Radio Access technology

Command Response Description

AT+URAT=1,0 OK Select GSM / UMTS Dual mode Radio Access
technology. GSM is the preferred access technology.
AT+URAT? +URAT: 1,0 With this configuration the module can access both
GSM and UMTS networks, GSM networks are
OK preferred.
AT+URAT=1,2 OK Select GSM / UMTS Dual mode Radio Access
technology. UMTS is the preferred access technology.
AT+URAT? +URAT: 1,2 With this configuration the module can access both
GSM and UMTS networks, UMTS networks are
OK preferred.
AT+COPS=0 OK Start automatic network registration.
AT+COPS? +COPS: 0,0,"vodafone IT",2 Check network registration status.
Last parameter (2 in this case) indicates the module is
OK registered to UMTS service.
AT+COPS? +COPS: 0,0,"vodafone IT",0 Module is also allowed to access GSM networks.
This will be the module response if it has registered to
OK GSM service.

UMTS Single Mode Radio Access technology

Command Response Description

AT+URAT=2,2 OK Select UMTS Single Mode Radio Access technology.
AT+URAT? +URAT: 2,2 With this configuration the module can access only
UMTS networks.
OK
AT+COPS=0 OK Start automatic network registration.
AT+COPS? +COPS: 0,0,"vodafone IT",2 Check network registration status.
Last parameter (2 in this case) indicates the module is
OK registered to UMTS service (as expected considering
that module is not allowed to access to GSM
networks).

If the module is registered in GSM / UMTS Dual Mode (AT+URAT=1,0 or AT+URAT=1,2) it is possible
to change preferred RAT technology but the new setting will take effect only after a period of lost
network coverage or if the module is deregistered and registered again on the network.

Command Response Description

AT+URAT=1,0 OK Select GSM / UMTS Dual mode Radio Access
technology. GSM is the preferred access technology.
AT+URAT? +URAT: 1,0 With this configuration the module can access both
GSM and UMTS networks, GSM networks are
OK preferred.
AT+COPS=0 OK Start automatic network registration.
AT+COPS? +COPS: 0,0,"vodafone IT",0 Check network registration status.
Last parameter (0 in this case) indicates the module is
OK registered to GSM service.
AT+URAT=1,2 OK Select GSM / UMTS Dual mode Radio Access
technology. UMTS is the preferred access technology.
AT+URAT? +URAT: 1,2 With this configuration the module can access both
GSM and UMTS networks, UMTS networks are
OK preferred.

GSM.G1-CS-09003-C1 Preliminary Page 8 of 39

 AT Commands Examples - Application Note

Command Response Description

AT+COPS? +COPS: 0,0,"vodafone IT",0 Last parameter (0 in this case) indicates the module is
still registered to GSM service although UMTS is now
OK the preferred access technology.
AT+COPS=2 OK Deregister the module from the network.
AT+COPS=0 OK Start automatic network registration.
AT+COPS? +COPS: 0,0,"vodafone IT",2 Last parameter (2 in this case) indicates the module is
registered to UMTS service.
OK

Note: this is only an example. Remember that with

URAT=1,2 UMTS is the preferred and not the
only allowed RAT. If the UMTS network
coverage is weak the module will register
again on GSM network.

AT+URAT=0,2 and AT+URAT=2,0 are allowed but the second parameter is ignored. The second
parameter is applied by the module only in GSM / UMTS Dual mode Radio Access technology (first
parameter equal to 1).

3.1.3.3 Check current network registration status

Command Response Description

AT+UREG? +UREG: 0,1 Check current network registration status.
The second parameter (1 in this example) indicates
OK that the device is attached to GPRS network.
AT+UREG? +UREG: 0,2 Check current network registration status.
2 means the module is registered and EDGE attached.
OK
AT+UREG? +UREG: 0,3 Check current network registration status.
3 means the module is registered and WCDMA
OK attached.
AT+UREG? +UREG: 0,4 Check current network registration status.
4 means the module is registered and HSDPA
OK attached.
AT+UREG=1 It is possible to enable a network registration attach
status URC.
+UREG: 1,2 A URC will be generated by DUT when network
attach status changes. The second parameter (in this
OK example 2) indicates the new network attach status
The first parameter is 1 meaning URC is still enabled.

In this table each row represents a possible combination of +URAT, +COPS and +UREG values. Other
combinations are not possible.

RAT configuration Operator Network registration status

+URAT: 0,0 +COPS: 0,0,"vodafone IT",0 +UREG: 0,1
+URAT: 0,0 +COPS: 0,0,"vodafone IT",0 +UREG: 0,2
+URAT: 1,0 +COPS: 0,0,"vodafone IT",0 +UREG: 0,1
+URAT: 1,0 +COPS: 0,0,"vodafone IT",0 +UREG: 0,2
+URAT: 1,0 +COPS: 0,0,"vodafone IT",2 +UREG: 0,3
+URAT: 1,0 +COPS: 0,0,"vodafone IT",2 +UREG: 0,4
+URAT: 1,2 +COPS: 0,0,"vodafone IT",0 +UREG: 0,1

GSM.G1-CS-09003-C1 Preliminary Page 9 of 39

 AT Commands Examples - Application Note

RAT configuration Operator Network registration status

+URAT: 1,2 +COPS: 0,0,"vodafone IT",0 +UREG: 0,2
+URAT: 1,2 +COPS: 0,0,"vodafone IT",2 +UREG: 0,3
+URAT: 1,2 +COPS: 0,0,"vodafone IT",2 +UREG: 0,4
+URAT: 2,2 +COPS: 0,0,"vodafone IT",2 +UREG: 0,3
+URAT: 2,2 +COPS: 0,0,"vodafone IT",2 +UREG: 0,4

4 GPRS connection
4.1 Context Activation
In order to use FTP, HTTP, SMTP and TCP/IP commands the following steps are necessary to establish a data
connection:
Command Response Description
AT+CGATT? +CGATT: 1 Check GPRS attach status.
Note: OK, the module is GPRS attached.
OK
Create a GPRS connection profile for TCP/IP with the
+UPSD command. This will be made in 2 steps:
1. Setup APN
2. Specify to use the dynamic IP address assignment

It is possible to configure up to 6 GPRS connection

profiles. Each profile is identified by a GPRS
connection profile identifier (an integer value from 0
to 6).
The profile identifier is the first parameter of
AT+UPSND, AT+UPSD, AT+UPSDA commands.

Note: AT+UPSD command does not affect the GPRS

profiles created with +CGDCONT command.
AT+UPSND=0,8 +UPSND: 0,8,0 Check if the GPRS connection profile associated to
OK GPRS connection profile identifier “0” is active.
In this case it’s not active.
Note: this step is not mandatory.
AT+UPSD=0,1,"web.omnitel.it" OK Setup APN for GPRS connection profile “0”.
Note: APN "web.omnitel.it" is an example only. Use
your operator APN.
AT+UPSD=0,7,"0.0.0.0" OK Setup the dynamic IP address assignment.

AT+UPSDA=0,1 OK Save GPRS profile in the NVM.

Note: this step is not mandatory.
AT+UPSDA=0,3 OK Activate the GPRS connection.
AT+UPSND=0,8 +UPSND: 0,8,1 Check if the GPRS connection profile associated to
OK GPRS connection profile identifier “0” is now active.
In this case it’s active.
Note: this step is not mandatory.
AT+UPSND=0,0 +UPSND: 0,0,"93.68.225.175" Check the assigned IP address.
OK Note: in this example is requested the assigned
dynamic IP address.

GSM.G1-CS-09003-C1 Preliminary Page 10 of 39

 AT Commands Examples - Application Note

4.2 Context Deactivation

4.2.1 Context Deactivation by the network

Command Response Description

+UUPSDD: 0 URC indicating that PDP context #0 is closed by the
network.

4.2.1 Context Deactivation by the module

Command Response Description

AT+UPSDA=0,4 OK Detach the GPRS connection identified by integer
number 0 with the +UPSDA command.

Note: the specified profile will be deactivated.

5 TCP/IP AT Commands
Before doing this example, verify that the module is registered on the network, and a GPRS connection is active.
Follow the steps in “Network Registration and Configuration” (chapter 3).

5.1 Socket Connect

Command Response Description

AT+USOCR=6 +USOCR: 0 Create TCP socket. In this example Socket #0 is
OK created.
+USOCR: 0 response returns the created socket
identifier (in this example #0). If a new socket is
created (without closing the already existent), a new
socket identifier will be returned.
AT+USOCR=6 +USOCR: 1 Create another socket. This socket has the ID #1.
OK
AT+USOCL=1 OK Close socket #1. Socket #1 is free.
AT+UDNSRN=0,"ftp.test.neonsev +UDNSRN: "151.9.34.66" DNS resolution of the URL “ftp.test.neonseven.com”.
en.com" OK
AT+USOCO=0,"151.9.34.66",444 OK Connect socket #0 to port 444 of a remote host with
IP address 151.9.34.66.

The connection is now uniquely associated to the

socket. Socket is now ready for read / write
operations.
AT+USOCO=0,"151.9.34.66",444 ERROR If the connection is not successful, an ERROR response
is returned and the socket used for the connection
+UUSOCL: 0 attempt is closed. The notification is provided by the
URC +UUSOCL.

GSM.G1-CS-09003-C1 Preliminary Page 11 of 39

 AT Commands Examples - Application Note

5.2 Socket Listening

Command Response Description

AT+USOCR=6 +USOCR: 0 Create a TCP socket with ID #0.
OK
AT+USOLI=0,1099 OK Set socket in listening mode on port 1099.

WARNING: The ability to reach the opened port

on the server depends also on the network
operator. Some network operators will not allow
incoming connection on opened TCP port.
+UUSOLI: When a connections request arrives from a remote
1,"151.9.34.66",39912,0, host, a new socket is created with the first integer
"151.9.34.74",1099 identifier available. In this example socket ID is #1.

+UUSOLI indicates:

1: the new socket created.. Incoming data from the

established connection will be received on this socket.
Data to be sent over the connection must be written
into this socket
151.9.34.66: IP of the remote server
39912: port of service
0: listening socket. It is the socket identifier specified
with the AT+USOLI command
151.9.34.74: IP address of the module
1099: listening port assigned to the connection.
Returned with AT+USOLI command
Socket #1 is now ready for reading/writing data
+UUSORD: 1,18 18 bytes of incoming data over the previously
established connection.

Note that data arrives on socket identified by integer

number 1 not on socket identified by integer
number 0. The incoming data will be sent
always on the related socket.

5.3 Socket Write

5.3.1 Binary mode

Command Response Description

AT+USOWR=0,2 @ Request to write 2 data bytes into socket #0. Wait
“@” symbol indicating the data prompt is now open
(AT commands are not allowed in data prompt).

GSM.G1-CS-09003-C1 Preliminary Page 12 of 39

 AT Commands Examples - Application Note

Command Response Description

12 +USOWR: 0,2 Write data bytes.
OK
It is not allowed to write fewer bytes than
previously specified with AT+USOWR command.

If more bytes are written with respect to the

threshold, the remaining bytes will be truncated.

The interface is blocked until all bytes are

written.

URC +USOWR: 0,2 and OK are returned. This means

that data is sent to lower level of protocol stack. This
is not a notification of an acknowledgment
received from the remote host data bytes have
been sent to.

5.3.2 Base syntax

Command Response Description

AT+USOWR=0,2,”12” +USOWR: 0,2 Write 2 data bytes data on socket #0.
OK

URC +USOWR: 0,2 and OK are returned. This means

that data is sent to lower level of protocol stack. This
is not a notification of an acknowledgment
received from the remote host data bytes have
been sent to.

Note: Some characters are not allowed in Base syntax

mode. Check the AT manual for the allowed
characters.

5.3.3 Queue FULL

Command Response Description

AT+USOWR=0,2,”12” ERROR If socket buffer is FULL data bytes inserted in data
prompt will be discarded.

This may happen in case of network congestion or in

case of network coverage lost.

In this case ERROR indication is returned.

AT+USOCTL=0,10 +USOCTL: 0,10,4 In case of ERROR response it’s recommended to query
the state of TCP connection associated to the socket
OK in order to verify the socket is still connected.

The third parameter of URC +USOCTL is the state; its

value is supposed to be 4 that means connection
ESTABILISHED.
AT+USOCTL=0,11 +USOCTL: 0,11,0 It’s also possible to query for TCP outcoming
unacknowledged data of the socket (this command is
OK valid only for TCP socket).

In this case 0 byte of data are unacknowledged.

GSM.G1-CS-09003-C1 Preliminary Page 13 of 39

 AT Commands Examples - Application Note

5.3.4 GSM network coverage lost

First scenario: Network coverage lost after AT+USOWR command

Command Response Description
AT+CREG=1 OK Enable network registration URC.

AT+USOCO=0,"151.9.34.66",444 OK Connect socket #0 to port 444 of a remote host with

IP address 151.9.34.66.

In this example a server that echoes data packets

it receives is used as remote host.

The socket is now ready for read / write data.

AT+USOWR=0,3 @ Request to write 3 data bytes on socket #0. Wait for
“@” symbol indicating the data prompt is now open
(AT commands are not allowed in data prompt).

123 +USOWR: 0,3 Write data bytes.

OK

It is not allowed to write fewer bytes than previously

specified with AT+USOWR command.

If more bytes are written with respect to the

threshold, the remaining bytes will be truncated.

The interface is blocked until all bytes are written.URC

+USOWR: 0,2 and OK are returned. This means that
data is sent to lower level of protocol stack. This is
not a notification of an acknowledgment
received from the remote host data bytes have
been sent to.
+UUSORD: 0,3 Remote TCP test server sent back data.

Coverage lost may be simulated by disconnecting the

antenna from the module. In this case it is not
possible to have GSM&GPRS signal coverage.
+CREG: 2 Module is not registered on a mobile network.
Currently in “search”-mode.
AT+USOWR=0,2 @ Request to write 2 data bytes into socket #0. Wait for
“@” symbol indicating the data prompt is now open
(AT commands are not allowed in data prompt).

GSM.G1-CS-09003-C1 Preliminary Page 14 of 39

 AT Commands Examples - Application Note

Command Response Description

12 +USOWR: 0,2 Write data. After the last byte the data prompt is
OK closed.

Note: It is not allowed to write fewer bytes than

previously specified with AT+USOWR
command.

Note: If more bytes are written with respect to the

threshold, the remaining bytes will be
truncated.
The interface is blocked until all bytes are written.

URC +USOWR: 0,2 and OK are returned. This means

that data is sent to lower level of protocol stack. This
is not a notification of an acknowledgment
received from the remote host data bytes have
been sent to.

The interface is blocked until all bytes are written.

Coverage lost may be simulated by disconnecting the
antenna from the module.
+CREG: 1 Module found network and is registered.

+UUSORD: 0,2 Remote TCP test server sent back data.

This means data has been sent immediately after

network coverage has been reestablished.

Second scenario: Network coverage lost during an AT+USOWR command

Command Response Description
AT+CREG=1 OK Enable network registration URC.
AT+USOCO=0,"151.9.34.66",444 OK Connect socket #0 to the remote host with IP address
151.9.34.66 on port 444.

In this example a server that echoes data packets

it receives is used as remote host.

The socket is now ready for read / write data.

AT+USOWR=0,100 @ Request to write 100 data bytes into socket #0. Wait
for “@” symbol indicating the data prompt is now
open (AT commands are not allowed in data prompt).

gggggggggggggggggggggggggg +CREG: 2 Module loses the network while writing data in data
prompt mode. If URC is enabled a URC is returned in
the byte stream.

GSM.G1-CS-09003-C1 Preliminary Page 15 of 39

 AT Commands Examples - Application Note

Command Response Description

ggggggggggggggggggggggggggggg +USOWR: 0,100 Continue writing data.
ggggggggggggggggggggggggggggg OK
gggggggggggggggg
After the last byte the data prompt is closed.

The command is blocking until the data writing is not

finished.

URC +USOWR: 0,2 and OK are returned. This means

that data is sent to lower level of protocol stack. This
is not a notification of an acknowledgment
received from the remote host data bytes have
been sent to.
+CREG: 1 Module found network and is registered.
+UUSORD: 0,100 Remote TCP test server sent back data.

This means data has been sent immediately after

network coverage has been reestablished.

5.4 Socket operations with “KEEP ALIVE” option

In “Keep Alive” mode, the module periodically sends dummy TCP packets to prevent the network from
closing the inactive context. The network operator may close inactive TCP connections without
notification to the mobile.

Command Response Description

AT+USOCR=6 +USOCR: 0 Create a TCP socket #0.
OK
AT+USOSO=0,6,2,3000 OK Enable “keep alive” option. Module periodically sends
dummy TCP packets over TCP connection. This
prevents network operator from closing inactive
connections.

0: socket number you want to set to enable keep alive

option

30000: module will send dummy TCP packets every

30000 milliseconds

5.5 Socket Read

First Scenario
Command Response Description
Remote server sends 2 data bytes on socket #0.

A URC is returned indicating the socket on which the

+UUSORD: 0,2
data is received and the total amount of data
received.
AT+USORD=0,2 +USORD: 0,2,"ar" Read data. Data is returned between quotation marks.
OK

GSM.G1-CS-09003-C1 Preliminary Page 16 of 39

 AT Commands Examples - Application Note

Second Scenario
Command Response Description

Remote server sends 30 data bytes on socket #0.

+UUSORD: 0,30 If a socket buffer is empty URC +UUSORD indicates a

TCP packet has been received from the remote host
the socket is connected to and the amount of data
bytes of the packet.
AT+USORD=0,10 +USORD: 0,10,"hfgyrhgfty" Read only part of data (in this example 10 bytes of
OK data are read).

Data is returned between quotation marks.

+UUSORD: 0,20

URC +UUSORD indicates the total amount of data

bytes stored in the buffer after last AT+USORD
execution. In this example 20 bytes are stored in the
buffer.

Third Scenario
Command Response Description
Remote server sends 30 data bytes on socket #0.

+UUSORD: 0,30 If a socket buffer is empty URC +UUSORD indicates a

TCP packet has been received from the remote host
the socket is connected to and the amount of data
bytes of the packet.
AT+USORD=0,10 +USORD: 0,10,"hfgyrhgfty" Only part of the data bytes (in this example 10 bytes)
OK are read.

Data is returned between quotation marks.

+UUSORD: 0,25

Remote server sent more data after the first part was
received. URC +UUSORD indicates the total amount of
data bytes stored the buffer after the last AT+USORD
execution. In this example 25 bytes are stored in the
buffer.
AT+USORD=0,10 +USORD: 0,10,"hfgbchs7[o" Only part of the data bytes (in this example 10 bytes)
OK are read.

Data is returned between quotation marks.

+UUSORD: 0,34
Remote server sent more data. URC +UUSORD
indicates the total amount of data bytes stored the
buffer after the last AT+USORD execution. In this
example 34 bytes are stored in the buffer.

AT+USORD=0,34 +USORD: All data bytes are read.

0,34,"jghfbv74ksHDFUEçpjè0’@è
pyujfnvhfyù"
OK

AT+USORD=0,0 +USORD: 0,0 Verifies how much unread data is in the buffer. In this
OK example 0 bytes are in socket #0.

GSM.G1-CS-09003-C1 Preliminary Page 17 of 39

 AT Commands Examples - Application Note

Fourth Scenario
Command Response Description

Remote host sends 30 bytes of data on socket #0.

+UUSORD: 0,30 If a socket buffer is empty URC +UUSORD indicates a

TCP packet has been received from the remote host
the socket is connected to and the amount of data
bytes of the packet.
AT+USORD=0,10 +USORD: 0,10,"hfgyrhgfty" Only part of the data bytes (in this example 10 bytes)
OK are read.

Data is returned between quotation marks.

+UUSORD: 0,25

Remote server sent other data after the first data

bytes had been received. URC +UUSORD indicates the
total amount of data bytes stored the buffer after last
AT+USORD execution. In this example 25 bytes are in
the buffer.
Remote host closes the TCP connection associated to
socket #0.

AT+USOWR=0,3 @ Request to write 3 data bytes into socket #0. Wait for
“@” symbol indicating the data prompt is now open.

123 +USOWR: 0,0 Write data. After the last byte the data prompt is
OK closed.

Note: It is not allowed to write fewer bytes than

previously specified with AT+USOWR
command.

Note: If more bytes are written with respect to the

threshold, the remaining bytes will be
truncated.

The interface is blocked until all bytes are written.

URC +USOWR: 0,0 indicates 0 bytes have been sent

to remote host. This means the TCP connection is
now closed.
AT+USORD=0,25 +USORD: Read the remaining data bytes still stored in the buffer
0,25,"23dfgt5uhj89ikdftevlpaz of socket #0.
we"

OK
+UUSOCL: 0 This URC indicates the TCP connection associated to
socket #0 is now closed and socket #0 is cleared.

5.6 Socket State

Command Response Description

AT+USOCTL=0,0 +USOCTL:0,0,6 Query the socket type of socket #0. The socket type is
OK TCP (<param_id> = 6).

GSM.G1-CS-09003-C1 Preliminary Page 18 of 39

 AT Commands Examples - Application Note

Command Response Description

AT+USOCTL=0,10 +USOCTL: 0,10,4 It’s possible to query the state of TCP connection
associated to the socket, in this example socket #0
OK (this command is valid only for TCP socket).

The third parameter of URC +USOCTL is the state; in

this example 4 means ESTABILISHED.
AT+USOCTL=0,10 +USOCTL: 0,10,7 In this example 7 means CLOSE_WAIT.

OK
If the socket state is 7 it means a TCP connection
termination procedure is being performed.

For a detailed description of TCP socket states see

+USOCTL command description in u-blox 2G
GSM/GPRS AT Commands Manual [1] or u-blox 3.5G
HSDPA AT Commands Manual [4].
AT+USOCTL=0,11 +USOCTL:0,11,0 Query for TCP outcoming unacknowledged data of
OK socket #0 (this command is valid only for TCP socket).
In this case 0 bytes of data are unacknowledged.
AT+USOCTL=0,1 +USOCTL:0,1,0 Query for the last socket error for socket #0. 0: no
OK errors.

5.7 Socket Close

By remote server
Command Response Description
+UUSOCL: 1 This URC indicates the TCP connection associated to
socket 1 is closed. Socket 1 is cleared.

WARNING: After this indication has been

received the socket buffer is cleared.

By the module
Command Response Description
AT+USOCL=0 OK Socket closed by the module (socket #0).

WARNING: No URC +UUSOCL is returned.

5.8 Direct Link

5.8.1 Enter and exit from Direct Link Mode

Command Response Description

AT+USOCR=6 +USOCR: 0 Create a TCP socket. In this example Socket #0 is
OK created.
+USOCR: 0 response returns the created socket
identifier (in this example #0). If a new socket is
created (without closing the already existent), a new
socket identifier will be returned.

GSM.G1-CS-09003-C1 Preliminary Page 19 of 39

 AT Commands Examples - Application Note

Command Response Description

AT+USOCO=0,"151.9.34.66",444 OK Connect socket #0 to port 444 of a remote host with
IP address 151.9.34.66.

The connection is now uniquely associated to the

socket. Socket is now ready for read / write
operations.
AT+USODL=0 CONNECT Activate direct link mode for socket #0.

Once user gets the response CONNECT, this means

that a transparent end to end communication has
been established with the previous connected TCP
socket via the serial interface.

Now data received on socket #0 will be redirected to

the serial port and data written on serial port will sent
to socket #0.
+++ DISCONNECT Exit from direct link mode; this will not close the
TCP connection.
OK
Now you are in command mode.

Data can be read or written on socket #0 using usual

TCP commands (+USOWR, +USORD).

Note: DISCONNECT message is provided for FW

versions higher than 07.40.02 for 2G modules
and for all FW versions on 3.5G modules.
AT+USODL=0 CONNECT Reactivate direct link mode for socket #0. Now data
received on socket #0 will be redirected to the serial
port and data written on serial port will sent to socket
#0.

5.8.2 Closing a connection

Command Response Description

+++ DISCONNECT First Exit from direct link mode; this will not close the
TCP connection. Now you are in command mode.
OK

Note: DISCONNECT message is provided for FW

versions higher than 07.40.02 for 2G modules
and for all FW versions on 3.5G modules.
AT+USOCL=0 OK Clear the socket the connection is associated to.

GSM.G1-CS-09003-C1 Preliminary Page 20 of 39

 AT Commands Examples - Application Note

5.8.3 Connection closed by remote host

Command Response Description

DISCONNECT If remote host closes the connection while a socket is
in direct link mode module exits from direct link
OK mode. OK and the indication of the number of the
socket has been closed is returned.
+UUSOCL: 0
If data is stored in the socket buffer when remote
host closes the connection, all data will be received
through the serial port before the closure notification.

Note: DISCONNECT message is provided for FW

versions higher than 07.40.02 for 2G modules
and for all FW versions on 3.5G modules.

For more details on “+++” escape sequence please refer to chapter 7.1.4.

If a context deactivation occurs open sockets become invalid. Close them and reinitialize TCP
connections.

6 UDP/IP AT Commands
6.1 Socket Write (+USOST)
Command Response Description
AT+USOCR=17 +USOCR: 0 Create a UDP socket. In this example Socket #0 is
OK created.

+USOCR: 0 response returns the created socket

identifier (in this example #0). If a new socket is
created (without closing the already existent), a new
socket identifier will be returned.
AT+USOCR=17,12000 +USOCR: 0,12000 It’s possible to create a UDP socket specifying the local
OK port to be used while sending data.

In this example Socket #0 is created and bound with

port 12000. Data written on socket #0 will be sent
from this specific port.
AT+USOST=0,"151.9.34.66",454, @ Request to write 2 bytes of data into socket #0
2 specifying IP address and UDP port of the remote host
UDP packet has to be sent to. Wait for “@” symbol
indicating the data prompt is now open (AT
commands are not allowed in data prompt).

GSM.G1-CS-09003-C1 Preliminary Page 21 of 39

 AT Commands Examples - Application Note

Command Response Description

12 +USOST: 0,2 Write data. After the last data byte is written, the
OK prompt is closed.

Note: It is not allowed to write fewer bytes than

previously specified with AT+USOST command.

Note: If more bytes are written with respect to the

threshold, the remaining bytes will be
truncated.

The interface is blocked until all bytes are written.

URC +USOST: 0,2 and OK are returned. This means

the data is sent to lower level of protocol stack. This is
not an acknowledgment, UDP is a connectionless
protocol.

6.2 Socket Read (+USORF)

Command Response Description

+UUSORD: 0,2 A UDP packet with 2 data bytes has been received
AT+USORF=0,2 +USORF: Read data.
0,"151.9.34.66",454,2,"12"
OK
+USORF indicates:

The ID of read socket

The remote IP address
The remote UDP port
The number of read data bytes
The read data bytes (between quotation marks)
+UUSORD: 0,20 UDP packet with 20 data bytes has been received
from remote server.
AT+USORF=0,10 +USORF: Read 10 data bytes. URC +UUSORD indicates that 10
0,"151.9.34.66",454,2,"123456 bytes are still unread.
7890"
OK

+UUSORD: 0,10
Remote host sends a UDP packet with 20 data bytes.
AT+USORF=0,10 +USORF: Read the remaining 10 data bytes of the previous
0,"151.9.34.66",454,2,"123456 packet. URC indicates 20 data bytes has been received
7890" and are still stored in the socket buffer.
OK

+UUSORD: 0,20 Note: after the first URC has been returned, a second
URC is returned (only after a reading operation)
indicating:
If a reading operation of a packet is not finished
it will be provided the remaining data of the
specific packet
Otherwise it will provide the number of data
bytes of packets stored in the socket buffer

GSM.G1-CS-09003-C1 Preliminary Page 22 of 39

 AT Commands Examples - Application Note

If the UDP socket is not set in listening mode (see +USOLI) it won’t be possible to receive any packet if a
previous write operation is not performed.

Due to the UDP specific AT commands, this command should be considered obsolete and it is strongly
recommend avoiding its usage while working with UDP sockets. The command’s functionality for UDP
socket is maintained for backward compatibility only, please consider to use +USOST and +USORF
command instead of +USOCO with +USOWR and +USORD.

6.3 Socket Write (+USOWR)

Command Response Description
AT+USOCR=17 +USOCR: 0 Create a UDP socket. In this example Socket #0 is
OK created.

+USOCR: 0 response returns the created socket

identifier (in this example #0). If a new socket is
created (without closing the already existent), a new
socket identifier will be returned.
AT+USOCR=17,12000 +USOCR: 0,12000 It’s possible to create a UDP socket specifying the local
OK port to be used while sending data.

In this example Socket #0 is created and bound with

port 12000. Data written on socket #0 will be sent
from this specific port.
AT+USOCO=0,"151.9.34.66",443 OK Specify IP address of the remote server and TCP port
where UDP packets have to be sent.

UDP is a connectionless protocol, reception of

UDP packets is not guaranteed, +USOCO does
not establish a connection.

Socket is now ready to send data to the remote server

or for receiving data from the remote server.
AT+USOWR=0,2 @ Request to write 2 bytes of data into socket #0.Wait
for “@” symbol indicating the data prompt is now
open (AT commands are not allowed in data prompt).
12 +USOWR: 0,2 Write data. After the last byte the data is written, the
OK prompt is closed.

Note: It is not allowed to write fewer bytes than

previously specified with AT+USOWR
command.
Note: If more bytes are written with respect to the
threshold, the remaining bytes will be
truncated.
The interface is blocked until all bytes are written.

URC +USOWR: 0,2 and OK are returned. This means

the data is sent to lower level of protocol stack. This is
not an acknowledgment.

GSM.G1-CS-09003-C1 Preliminary Page 23 of 39

 AT Commands Examples - Application Note

6.4 Socket Read (+USORD)

Command Response Description

+UUSORD: 0,2 A UDP packet with 2 data bytes has been received
from remote server.
AT+USORD=0,2 +USORD: 0,2,”23” Read the data.
OK
+UUSORD: 0,20 A UDP packet with 2 data bytes has been received
from remote server.
AT+USORD=0,10 +USORD: 0,10,”1234567890” Read 10 bytes of data. URC indicates that 10 bytes
OK are still unread.

+UUSORD: 0,10
UDP packet with 20 byte of data received from
remote server.
AT+USORD=0,10 +USORD: 0,10,”1234567890” Read the remaining 10 data bytes of the previous
OK packet. URC indicates 20 data bytes has been received
and are still stored in the socket buffer.
+UUSORD: 0,20
Note: after the first URC has been returned, a second
URC is returned (only after a reading operation)
indicating:
If a reading operation of a packet is not finished
it will be provided the remaining data of the
specific packet
Otherwise it will provide the number of data
bytes of packets stored in the socket buffer

If the UDP socket is not set in listening mode (see +USOLI) it won’t be possible to receive any packet if a
previous write operation is not performed.

7 FTP AT Commands
Make sure to follow the steps in “Network Registration and Configuration” (chapter 3) before using the AT
commands in this chapter.
First do preliminary configuration:
1. Set verbose error messages
2. Check the PIN
3. Attach to the network

Command Response Description

Configure the parameters needed to connect to the
FTP server using the +UFTP command.
These parameters will be set:
FTP server hostname
AT+UFTP=1,"ftp.test.neonseven OK
.com"
FTP username
AT+UFTP=2,"anonymous" OK
FTP password
AT+UFTP=3,"[email protected] OK
m"
FTP connection mode (ACTIVE connection)
AT+UFTP=6,0 OK

GSM.G1-CS-09003-C1 Preliminary Page 24 of 39

 AT Commands Examples - Application Note

Command Response Description

AT+UDNSRN=0,"ftp.test.neonsev +UDNSRN:"216.239.59.147" Resolve the hostname.
en.com" OK
Connect to the server and manage the FTP
Connection using the +UFTPC command. Let’s start
connecting to the server.
AT+UFTPC=1 OK
+UUFTPCR: 1,1
Note: URC +UUFTPCR is returned when the
connection is established.
AT+UFTPC=13 OK Request the file-list on the server.
+UUFTPCD: 13,194,"-rw-r--r--
1 ftp ftp 1037
Aug 5 09:45 dat_000
-rw-r--r-- 1 ftp ftp
21041 Aug 5 09:12 data.zip
-rw-r--r-- 1 ftp ftp
12 Aug 5 09:42 xlog.zip
"

+UUFTPCR: 13,1
AT+UFTPC=10,"uploads" OK Create a new directory on the FTP server.
+UUFTPCR: 10,1
AT+UFTPC=13 OK Request again the file list.

+UUFTPCD: 13,258,"-rw-r--r--
1 ftp ftp 1037
Aug 5 09:45 dat_000
-rw-r--r-- 1 ftp ftp
21041 Aug 5 09:12 data.zip
drwxr-xr-x 2 ftp ftp
4096 Aug 5 09:48 uploads
-rw-r--r-- 1 ftp ftp
12 Aug 5 09:42 xlog.zip
"

+UUFTPCR: 13,1
Change directory to directory name "uploads".
AT+UFTPC=8,"uploads" OK Note: to return back in the parent directory use
+UUFTPCR: 8,1 AT+UFTPC=8,"..".
AT+UFTPC=5,"gps_positions","g OK Upload a file from the module to FTP server from local
ps_positions" +UUFTPCR: 5,1 file system of the module (in this example filename
“gps_positions”).
AT+UFTPC=13 OK Request the file list.

+UUFTPCD: 13,70,"-rw-r--r--
1 ftp ftp 176673
Aug 5 10:03 gps_positions"

+UUFTPCR: 13,1
AT+UFTPC=8,".." OK Return to the parent directory.
+UUFTPCR: 8,1
AT+UFTPC=4,"data.zip","data.z OK Download a file from the FTP server to the local file
ip" +UUFTPCR: 4,1 system of the module.
AT+UFTPC=0 OK Disconnect from FTP server.
+UUFTPCR: 0,1
AT+UPSDA=0,4 OK Detach the GPRS connection with the +UPSDA
command.
Note: the specified profile will be deactivated.

To list and view all files stored in the wireless module file system, refer to chapter 15.

GSM.G1-CS-09003-C1 Preliminary Page 25 of 39

 AT Commands Examples - Application Note

7.1 Direct Link

7.1.1 Retrieve a file from FTP server

Command Response Description

Configure the parameters needed to connect to the
FTP server using the +UFTP command.
These parameters will be set:
FTP server hostname
AT+UFTP=1,"ftp.test.neonseven OK
.com"
FTP username
AT+UFTP=2,"anonymous" OK
FTP password
AT+UFTP=3,"[email protected] OK
m"
FTP connection mode (ACTIVE connection)
AT+UFTP=6,0 OK
AT+UDNSRN=0,"ftp.test.neonsev +UDNSRN:"216.239.59.147" Resolve the hostname.
en.com" OK
Connect to the server and manage the FTP
Connection using the +UFTPC command. Let’s start
connecting to the server.
AT+UFTPC=1 OK
+UUFTPCR: 1,1
Note: URC +UUFTPCR is returned when the
connection is established.
AT+UFTPC=6,"file_to_retrieve" CONNECT Send to FTP server a RETRIEVE file request for
file_to_retrieve.

Once user gets the response CONNECT direct link

mode is activated. Data received from FTP connection
will be redirected to the serial port.
+++ DISCONNECT WARNING: When the file has entirely been
retrieved module does not exit from direct link
OK mode. It’s necessary to exit manually using “+++”
escape sequence.
+UUFTPCR: 6,1
URC +UUFTPCR notifies if retrieve operation has been
concluded successfully.

Note: DISCONNECT message is provided for FW

versions higher than 07.40.02 for 2G modules
and for all FW versions on 3.5G modules.

GSM.G1-CS-09003-C1 Preliminary Page 26 of 39

 AT Commands Examples - Application Note

7.1.2 Aborting retrieve file request

Command Response Description

+++ DISCONNECT If entering “+++” escape sequence before the
requested file has been entirely retrieved from FTP
OK server, module exits from direct link and URC
+UUFTPCR notifies that retrieve operation hasn’t been
+UUFTPCR: 6,0 concluded successfully.

Note: DISCONNECT message is provided for FW

versions higher than 07.40.02 for 2G modules
and for all FW versions on 3.5G modules.

7.1.3 Store a file on FTP server

Command Response Description

Configure the parameters needed to connect to the
FTP server using the +UFTP command.
These parameters will be set:
FTP server hostname
AT+UFTP=1,"ftp.test.neonseven OK
.com"
FTP username
AT+UFTP=2,"anonymous" OK
FTP password
AT+UFTP=3,"[email protected] OK
m"
FTP connection mode (ACTIVE connection)
AT+UFTP=6,0 OK
AT+UDNSRN=0,"ftp.test.neonsev +UDNSRN:"216.239.59.147" Resolve the hostname.
en.com" OK
Connect to the server and manage the FTP.
Connection using the +UFTPC command. Let’s start
connecting to the server.
AT+UFTPC=1 OK
+UUFTPCR: 1,1
Note: URC +UUFTPCR is returned when the
connection is established.
AT+UFTPC=7,"file_to_store" CONNECT Send to FTP server a STORE file request for
file_to_store.

Once user gets the response CONNECT direct link

mode is activated. Data sent through the serial port
will be redirected to FTP server through the FTP
connection.
+++ DISCONNECT When data upload is concluded use “+++” escape
sequence for exiting from direct link mode.
OK
The URC +UUFTPCR notifies if STORE operation has
+UUFTPCR: 7,1
been concluded successfully.

GSM.G1-CS-09003-C1 Preliminary Page 27 of 39

 AT Commands Examples - Application Note

7.1.4 About “+++” escape sequence usage

To switch from data mode to command mode a proper escape sequence shall be sent by the application to the
module. The application can configure the escape sequence by means of the following:
ATS2: this command is used to set the character used as the escape character (default is ‘+’)
ATS12: this command is used to set the escape prompt delay (TEPD) timer (default is 1 second)
For more details on the AT commands please refer to u-blox 2G GSM/GPRS AT Commands Manual [1].
The escape sequence must follow certain timing constraints to be distinguished from generic data.

data + + + AT command UART RX

time
T0 T1 T2 T3

T0 > TEPD: there must be at least TEPD seconds after the last data byte and the first escape character
T1 < TEPD: the second escape character must be sent within TEPD seconds after the first escape character
T2 < TEPD: the third escape character must be sent within T EPD seconds after the second escape character
T3 > TEPD: There must be at least TEPD seconds after the last escape character and the first AT command

8 SMTP AT Commands
Make sure to follow the steps in “Network Registration and Configuration” (chapter 3) before using the AT
commands in this chapter.

Command Response Description

Set up the necessary parameters for SMTP using the
+USMTP.

AT+USMTP=1,"smtp.mail.yahoo.c OK 1. SMTP server hostname

om"
2. Authentication type (no authentication)
AT+USMTP=4,0 OK 3. Inactivity timeout

AT+USMTP=5,3600 OK
AT+UDNSRN=0, "smtp.mail.yahoo +UDNSRN:"69.147.102.58" Resolve the hostname.
.com" OK

GSM.G1-CS-09003-C1 Preliminary Page 28 of 39

 AT Commands Examples - Application Note

Command Response Description

Prepare the mail envelope and body using the
+USMTPM command.

AT+USMTPM OK 4. Reset all the parameters

5. Set up mail sender address
AT+USMTPM=0,"test.sender@yaho OK
o.com" 6. Set up the reply-to mail address
7. Set up the mail receiver address
AT+USMTPM=1,"test.sender@yaho OK
o.com" Note: the specified mail addresses only examples. Use
real email addresses.
AT+USMTPM=2,"receiver@somedom OK
ain.com"

AT+USMTPM=3,"This is the
subject of the email" OK 8. Set up the mail subject

AT+USMTPM=4,"This is the body

9. Set up the mail text
text of the email" OK

AT+USMTPM=5,"screenshot.jpg", 10. Set up the attachment stored in file system

2,"jpg" OK
Note: "screenshot.jpg" is a filename for example only.
Specify filenames stored into the file system.

Send the email using the +USMTPC command. To

send an email it is needed to:

AT+USMTPC=1 OK 1. Connect to the SMTP server

+UUSMTPCR: 1,1
2. Send the email
AT+USMTPC=2 OK
+UUSMTPCR: 2,1
3. Disconnect from the SMTP server
AT+USMTPC=0 OK Note: the notification of the success of the operation
+UUSMTPCR: 0,1 is provided by the reception of the URC
+UUSMTPCR.
AT+USMTPM OK Reset the mail parameters.
AT+UPSDA=0,4 OK Finally detach the GPRS connection with the +UPSDA
command.
Note: the specified profile will be deactivated.

9 HTTP AT Commands
Make sure to follow the steps in “Network Registration and Configuration” (chapter 3) before using the AT
commands in this chapter.

Command Response Description

AT+CMEE=2 OK Set verbose error messages.
AT+UHTTP=0 OK Reset HTTP profile #0.
AT+UHTTP=0,1,"www.test.neonse Set the server domain name and port.
ven.com" OK

AT+UHTTP=0,4,80 OK
AT+UDNSRN=0, "www.test.neonse DNS resolution of www.test.neonseven.com.
ven.com" +UDNSRN: "151.9.34.66"
OK

GSM.G1-CS-09003-C1 Preliminary Page 29 of 39

 AT Commands Examples - Application Note

Command Response Description

AT+UHTTPC=0,0,"/","head.ffs" OK HEAD request of default page and store the result
into the "head.ffs" file on local file system of the
+UUHTTPCR=0,0,1 module. +UUHTTPCR notifies success/failure of the
operation (in this example: success).
AT+UHTTPC=0,1,"/","get.ffs" OK GET request of default page and store the result into
the "get.ffs" file on local file system of the module.
+UUHTTPCR=0,1,1 +UUHTTPCR notifies success/failure of the operation
(in this example: success).
AT+UHTTPC=0,5,"/test/plain/me POST request sending data using content type
thod_post.php","post.ffs","na application/x-www-form-urlencoded. The result is
me_post=MyName&age_post=30",0 OK saved in "post.ffs" file on local file system of the
module. +UUHTTPCR notifies success/failure of the
+UUHTTPCR=0,5,1 operation (in this example: success).

Set authentication for HTTP server:

HTTP server username
AT+UHTTP=0,2,"test_user" OK
HTTP server password
AT+UHTTP=0,3,”P455w0rd" HTTP server authentication method (basic
OK authentication)
AT+UHTTP=0,4,1
OK
The 6th character of the password is a zero.
at+uhttpc=0,5,"/test/auth/met POST request sending data using content type
hod_post.php","post_auth.ffs" application/x-www-form-url encoded.
,"name_post=MyName&age_post=2
6",0 The page requires basic authentication.
OK
The result is saved in "post_auth.ffs" file on local file
system of the module. +UUHTTPCR notifies
success/failure of the operation (in this example:
success).
+UUHTTPCR=0,5,1

To list and view all files stored in the wireless module file system, refer to chapter 15.

10 GPS AT Commands
Using AT-commands in this chapter can create / use several files on the local file system:
gps_profile (contains the GPS settings, e.g. AssistNow servers parameters)
xxxxxx.alp (almanac file for AssistNow Offline)
GPS_YYYYMMDD_nnn (GPS log on File System: YYYYMMDD is the date, nnn is an incremental index)
Before doing these examples, make sure the module is registered on the network. Follow the steps in “Network
Registration and Configuration” (chapter 3).

10.1 Using GPS without aiding support

Once GPS is on, it is not possible to restart it in another mode without first shutting it down.
Local Aiding action can be executed when the GPS is on by using +UGAOS command.

Command Response Description

AT+UGPS=1,0 OK Start up the GPS.
AT+UGRMC? +UGRMC: Check if GPS data are sent from GPS to GSM by I 2C
1,$GPRMC,,V,,,,,,,,,,N*53 and see if a fix has been made.
AT+UGPS=0 OK Stop the GPS.

GSM.G1-CS-09003-C1 Preliminary Page 30 of 39

 AT Commands Examples - Application Note

10.2 Using GPS with local aiding support

When local aiding is enabled the wireless module at shut down will download position, time, ephemeris,
almanac and health, and ionospheric parameters from the GPS receiver. At the same time, the GSM network
location (e.g. Cell ID) will be saved. At subsequent start up this data is uploaded to the GPS receiver: the wireless
module uses the last known position and adjusts the accuracy figure assuming the dynamics of a fast moving
vehicle (e.g. 150 km/h). If however, the Cell ID has not changed, the last known position is used with an
accuracy figure of a maximum cell coverage radius (30 km). In case of no knowledge of the previous position, a
central position of the network should be used (e.g. Rome for Italian networks) with the accuracy figure
reflecting the uncertainty (e.g. a few 100 km in case of Italy).

Command Response Description

AT+COPS? +COPS: 0,0,"vodafone IT" Check if the modem is registered on a GSM network
(GPS local aiding will use GSM information to reduce
TTFF).
AT+UGPS=1,1 OK Start up the GPS with local aiding (it will download
orbits, time and position to GPS if available in file
system, otherwise it will use country code information
for a rough localization).
AT+UGRMC? +UGRMC: Wait at least 15’ for ephemeris download.
1,$GPRMC,102140.00,A,4542.852
11,N,01344.44959,E,0.356,34.9
2,261009,,,A*57
AT+UGPS=0 OK Stop the GPS. Automatically the module will create
some file hidden to the user: ubx_aid_ini.dat,
ubx_aid_eph.dat, ubx_aid_hui.dat, ubx_aid_alm.dat
and local_aid_info.bin (contains GPS coordinate, GPS
time, fix accuracy, system time, GSM cell info).

10.3 Using GPS with AssistNow Offline support

In case of AssistNow Offline, a file with Differential Almanac Correction data must be in the local file system. If
the file is not there, the module will try to download it from a server.
If download fails, the system will automatically retry the download according to the parameter specified by
+UGAOF command. In case of error, GPS will be started anyway, but no AssistNow Local is not possible.

Command Response Description

AT+UPSDA=0,3 OK Activate the GPRS connection using the +UPSDA
command (needed only if there is no valid almanac file
in file system).
AT+UGAOF? +UGAOF: "http://alp.u- Check if AssistNow Offline is configured (eventually
blox.com/current_14d.alp",0,1 configure it) (needed only if there is no valid almanac
,3 file in file system).

AT+UGPS=1,2 OK Start up the GPS with AssistNow Offline aiding (it will
download to file system the .alp field from the specified
server if there is no file on file system).
AT+UGPS=0 OK Stop the GPS.

10.4 Using GPS with AssistNow Online support

In this mode a UDP connection is made with either the u-blox AssistNow Online Server (agps.u-blox.com) or a
configurable proxy server.
In case of no response to AssistNow Online the wireless module will make 3 retry (at intervals of 10 s, 30 s and
60 s respectively).

GSM.G1-CS-09003-C1 Preliminary Page 31 of 39

 AT Commands Examples - Application Note

Authentication for u-blox AssistNow Online Server (agps.u-blox.com) is done at the beginning of a server access
to the u-blox AssistNow server by sending the information listed below:
Exor of IMSI and IMEI
Home network code (not IMSI)
MCC, MNC, LAC, CI, TA of cell and neighboring cells used by the wireless module
Latency
After a successful (=GPS Fix OK) Assistance, the module provides the information below back to the server, for
quality monitoring purposes:
Exor of IMSI and IMEI
Calculated position after aiding
Position accuracy
Number of SV used
TTFF

Command Response Description

AT+UPSDA=0,3 OK Activate the GPRS connection using the +UPSDA
command.
AT+UGAOP? +UGAOP: "agps.u- Check if AssistNow Online is configured. (if not, than
blox.com",46434,1000,0 needs to be configured first).
AT+UGPS=1,4 OK Start up the GPS with AssistNow Online aiding (it will
send to the server GSM cell info and will receive back
aiding data for the GPS).
AT+UGPS=0 OK Stop the GPS.

10.5 Additional GPS AT commands

2
GPS data can be redirected from the I C to a MUX virtual channel, or be written in a file in file system, or sent
over the air. These modes can be combined.
The file-size of the log-file is limited to 500 kB. If there is no more space in the file system, the file is closed and
no more logs are recorded. Output configuration can be done only when GPS is off.

Command Response Description

AT+UGPRF=4 OK Enable GPS trace on file system.
AT+UPSDA=0,3 OK Activate the GPRS connection using the +UPSDA
command.
AT+UGPS=1,0 OK Start up the GPS without aiding.
AT+UGAOS=4 OK Force AssistNow Online and wait some minutes.
AT+UGPS=0 OK Stop the GPS.
AT+ULSTFILE= "gps_profile","GPS_20040101_0 Check if trace file has been generated.
01"
AT+UGPRF=6 OK Start the mux driver on host and then enable GPS
communication on MUX and trace on file system.
AT+UGPS=1,0 OK Start up the GPS without aiding, the GPS output will be
visible on DLC1 (1st mux channel).
AT+UGAOS=0 OK Force local aiding data download.
AT+UGPS=0 OK Stop the GPS.
AT+ULSTFILE= "gps_profile","GPS_20040101_0 Check if trace file has been generated.
02","GPS_20040101_001"

GSM.G1-CS-09003-C1 Preliminary Page 32 of 39

 AT Commands Examples - Application Note

11 Network Congestion Detection AT Commands

11.1 GSM module

Command Response Description
AT+CMEE=2 OK Set verbose error messages.
AT+UCD=1,12,18 OK Enable and configure the congestion detection.
+UCD: 1 If congestion is detected (depends on the +UCD
configuration) a URC (+UCD) is raised.
AT+UCD=0 OK Disable network congestion detection.

11.2 UMTS module

11.2.1 2G congestion detection
Command Response Description
AT+CMEE=2 OK Set verbose error messages.
AT+UCD=1,12,18 OK Enable and configure the 2G congestion detection.
+UCD: 1 If 2G congestion is detected (depends on the +UCD
configuration) a URC (+UCD) is raised.
AT+UCD=0 OK Disable network congestion detection.

11.2.2 3G congestion detection

Command Response Description
AT+CMEE=2 OK Set verbose error messages.
AT+UCD=2,,,50,21 OK Enable and configure the 3G congestion detection.
+UCD: 3 If 3G congestion is detected (depends on the +UCD
configuration) a URC (+UCD) is raised.
AT+UCD=0 OK Disable network congestion detection.

11.2.3 2G and 3G congestion detection

Command Response Description
AT+CMEE=2 OK Set verbose error messages.
AT+UCD=3,12,18,50,21 OK Enable and configure the 2G/3G congestion
detection.
+UCD: 1 If 2G congestion is detected (depends on the +UCD
configuration) a URC (+UCD) is raised.
+UCD: 3 If 3G congestion is detected (depends on the +UCD
configuration) a URC (+UCD) is raised.
+UCD: 0 If 2G congestion condition is cleared a URC (+UCD) is
raised.

GSM.G1-CS-09003-C1 Preliminary Page 33 of 39

 AT Commands Examples - Application Note

Command Response Description

AT+UCD=0 OK Disable network congestion detection.

12 ADC AT Commands (if supported)

Command Response Description
AT+CMEE=2 OK Set verbose error messages.
AT+UADC=? +UADC: (0) Check the current values of ADC parameters.
OK
AT+UADC=0 +UADC: 0,473 Check the current value (in milliVolts) of the specified
OK ADC.

13 GPIO AT Commands
Command Response Description
AT+CMEE=2 OK Set verbose error messages.
AT+UGPIOR=? +UGPIOR: (20, 21) GPIO pin numbers.
OK
For LEON GPIO1 is pin 20, GPIO2 is pin 21
For LUCY GPIO1 is pin 54, GPIO2 is pin 53, GPIO3 is
pin 41, GPIO4 is pin 39, GPIO5 is pin 31.

Set up the GPIO input / output mode:

GPIO1 in output mode with default value 0
AT+UGPIOC=20,0,0 OK
GPIO2 in input mode (no default value can be
AT+UGPIOC=21,1 OK set)
AT+UGPIOR=20 +UGPIOR: 20,0 Read the GPIO status.
OK

AT+UGPIOR=21 +UGPIOR: 21,1

OK
AT+UGPIOW=20,1 OK Write (set) the GPIO status.
Note: only GPIO configured in output mode can be
written.
AT+UGPIOC=21,2 OK Configure GPIO2 to be used as network indication.
AT+UGPIOC=? +UGPIOC: (20, 21),(0-3),(0-1) Provides GPIO status (GPIO1 is an output with value 0
20, 0, 1 and GPIO2 is set as network configuration).
21, 2
OK
AT+UGPIOW=21,1 +CME ERROR: Write GPIO error Write into a GPIO in input mode. Error is returned.

14 MUX AT Commands
There are 6 virtual channels for the MUX. CHANNEL 0 is used for the MUX control channel, Channels 1 to 5 can
be used for AT commands or GSM/GPRS data (note there can be only 1 data channel). GPS in tunneling mode
will use Channel #6.

GSM.G1-CS-09003-C1 Preliminary Page 34 of 39

 AT Commands Examples - Application Note

AT+CMUX command has to be sent by the mux driver on host. When the control channel is closed the
mux is disabled. To close the mux channel it is necessary to stop the mux driver; after this the channel
#0 will not be seen as a virtual port.

Command Response Description

AT+CMEE=2 OK Set verbose error messages.
AT+CMUX=0,0,0,1400,253,3,254, OK Enable the MUX on the module. Once the MUX is
0,0 started you need to handle the connection using the
multiplexing protocol as defined in 3GPP 27.010 [2].

15 File System AT commands

Commands in this chapter refer to the local file system on the module. The size of the file system is
limited by the available memory. Refer to u-blox 2G GSM/GPRS AT Commands Manual [1] or
u-blox 3.5G HSDPA AT Commands Manual [4].

Command Response Description

AT+CMEE=2 OK Set verbose error messages.
AT+ULSTFILE= +ULSTFILE:"a_file","another_f List all the files in the file system.
ile","mydata"

OK
AT+ULSTFILE=1 +ULSTFILE: 1012131 Get free space in the file system (in bytes).

OK
AT+ULSTFILE=2,"a_file" +ULSTFILE: 24365 Get file size of “a_file” file (in bytes).

OK
AT+ULSTFILE=2,"some_name" +ULSTFILE: 0 If the specified file does not exist a 0 bytes dimension is
returned.
OK
AT+UDWNFILE="new_file",12 > Request the creation of a new file on file system
specifying file name and file size (in bytes).
Wait for “>” symbol indicating the data prompt is now
open (AT commands are not allowed in data prompt).
Hello World! OK Send to serial port the bytes to be written in the
specified file.

Note: It is not possible to write fewer bytes than

previously specified with AT+UDWNFILE
command.

Note: If more bytes are written with respect to the

threshold, the remaining bytes will be truncated.

The interface is blocked until all bytes are written.

When the requested number of bytes are written

module exits from data prompt, OK is returned if no
error occurred during file creation.
AT+ULSTFILE= +ULSTFILE:"a_file","another_f List again all the files in the file system.
ile","mydata","new_file"

OK

GSM.G1-CS-09003-C1 Preliminary Page 35 of 39

 AT Commands Examples - Application Note

Command Response Description

AT+URDFILE=2,"new_file" +URDFILE: 12 Get file size of “new_file” file (in bytes). The size is
exactly the size requested when file was created with
OK +UDWNFILE.
AT+URDFILE="new_file" +URDFILE: new_file,12,"Hello Read the just created file ("new_file").
World!"
OK
AT+UDELFILE="new_file" OK Delete the file called "new_file".
AT+ULSTFILE= +ULSTFILE:"a_file","another_f List all the file in the file system.
ile","mydata"
OK

Appendix
A List of Acronyms
Abbreviation / Term Explanation / Definition
3GPP 3rd Generation Partnership Project

ADC Analog to Digital Converter

APN Access Point Name

AT AT Command Interpreter Software Subsystem, or attention

CI Cell Identity

CTS Clear To Send

DLC Data Link Connection

DNS Domain Name System

DTE Data Terminal Equipment

DUT Device Under Test

EDGE Enhanced Data rates for GSM Evolution

FTP File Transfer Protocol

GPIO General Purpose Input Output

GPRS General Packet Radio Service

GPS Global Positioning System

GSM Global System for Mobile Communication

HSDPA High Speed Downlink Packet Access

HTTP HyperText Transfer Protocol

2
IC Inter-Integrated Circuit

IMEI International Mobile Equipment Identity

IMSI International Mobile Station Identity

IP Internet Protocol

LAC Location Area Code

MCC Mobile Country Code

MNC Mobile Network Code

NVM Non Volatile Memory

GSM.G1-CS-09003-C1 Preliminary Page 36 of 39

 AT Commands Examples - Application Note

Abbreviation / Term Explanation / Definition

PDP Parallel Data Processing

PIN Personal Identification Number

RAT Radio Access Technology

RTS Request To Send

SIM Subscriber Identification Module

SV Satellite in View

SMTP Simple Mail Transfer Protocol

TA Timing Advance

TCP Transmission Control Protocol

TTFF Time To First Fix

UDP User Datagram Protocol

UMTS Universal Mobile Telecommunications System

URC Unsolicited Result Code

URL Uniform Resource Locator

WCDMA Wideband CODE Division Multiple Access

GSM.G1-CS-09003-C1 Preliminary Page 37 of 39

 AT Commands Examples - Application Note

Related documents
[1] u-blox 2G GSM/GPRS AT Commands Manual, Docu. No GSM.G1-SW-09002 available on our
homepage (http://www.u-blox.com).
[2] 3GPP TS 27.010 - Terminal Equipment to User Equipment (TE-UE) multiplexer protocol (Release 1999)
[3] LEON-G100/G200 System Integration Manual, Docu. No. GSM.G1-HW-09002 available on our
homepage (http://www.u-blox.com).
[4] u-blox 3.5G HSDPA AT Commands Manual, Document No 3G.G1-SW-10000 available on our
homepage (http://www.u-blox.com)

For regular updates to u-blox documentation and to receive product change notifications please register
on our homepage.

Revision history
Revision Date Name Status / Comments
- 29/01/2009 fves Initial release
A 13/11/2009 lpah/sgod/tgri Changed order of chapters, update of List of Acronyms, added the
chapter HTTP AT commands and file system AT commands, update
of chapter 4 (TCP/IP AT Commands), added the chapter 8 (GPS AT
Commands), change of document status to “Preliminary”.

B 15/04/2010 lpah Added Direct Link Mode chapter

C 11/06/2010 lpah Added examples for 3G modules
C1 15/07/2010 mnob Added DISCONNECT message for Direct mode

GSM.G1-CS-09003-C1 Preliminary Page 38 of 39

 AT Commands Examples - Application Note

Contact
For complete contact information visit us at www.u-blox.com

u-blox Offices

North, Central and South America Headquarters Asia, Australia, Pacific

Europe, Middle East, Africa
u-blox America, Inc. u-blox Singapore Pte. Ltd.
Phone: +1 (703) 483 3180 u-blox AG Phone: +65 6734 3811
E-mail: [email protected] Phone: +41 44 722 74 44 E-mail: [email protected]
E-mail: [email protected] Support: [email protected]
Regional Office West Coast:
Support: support @u-blox.com
Phone: +1 (703) 483 3184 Regional Office China:
E-mail: [email protected] Phone: +86 10 68 133 545
E-mail: [email protected]
Technical Support: Support: [email protected]
Phone: +1 (703) 483 3185
E-mail: [email protected] Regional Office Japan:
Phone: +81 3 5775 3850
E-mail: [email protected]
Support: [email protected]

Regional Office Korea:

Phone: +82 2 542 0861
E-mail: [email protected]
Support: [email protected]

Regional Office Taiwan:

Phone: +886 2 2657 1090
E-mail: [email protected]
Support: [email protected]

GSM.G1-CS-09003-C1 Preliminary Page 39 of 39