UbiNetics Ltd
Cambridge Technology Centre
Melbourn
Herts SG8 6DP
Tel: +44 (0) 1763 285 183
Prepared by: Chris Cockings Fax: +44 (0) 1763 260 023
Date: 09-04-2001 http://www.ubinetics.com
Document Number: BCO-00-0621-AN Email: support@ubinetics.com
Table of Contents
1. Overview ...................................................................................................... 7
2. Definitions and Abbreviations....................................................................... 8
3. Format of the AT Command String and Result Code................................. 10
4. Commands Specified by GSM 07.07 ......................................................... 12
4.1 General Commands .........................................................................................12
4.1.1 AT+CGMI, Request Manufacturer Identification.........................................12
4.1.2 AT+CGMM, Request Model Identification..................................................12
4.1.3 AT+CGMR, Request Revision Identification ..............................................12
4.1.4 AT+CGSN, Request Product Serial Number Identification.........................12
4.1.5 AT+CSCS, Select TE Character Set..........................................................12
4.1.6 AT+CIMI, Request International Mobile Subscriber Identity.......................13
4.1.7 AT+WS46, Select Wireless Network..........................................................13
4.2 Call Control Commands....................................................................................13
4.2.1 ATD, Dial Command..................................................................................13
4.2.2 ATD>, Dial Selected Phone Book ..............................................................14
4.2.3 ATD>, Dial Current Phone Book................................................................14
4.2.4 AT+CHUP, Hangup Call ............................................................................14
4.2.5 AT+CBST, Select Bearer Service Type .....................................................15
4.2.6 AT+CRLP, Radio Link Protocol .................................................................15
4.2.7 AT+CR, Service Reporting Control ............................................................16
4.2.8 AT+CEER, Extended Error Report ............................................................16
4.2.9 AT+CRC, Cellular Result Codes................................................................18
4.3 Network Service Related Commands ...............................................................18
4.3.1 AT+CNUM, Subscriber Number ................................................................18
4.3.2 AT+CREG, Network Registration ..............................................................19
4.3.3 AT+COPS, Operator Selection ..................................................................19
4.3.4 AT+CLCK, Facility Lock.............................................................................20
4.3.5 AT+CPWD, Change Password..................................................................21
4.3.6 AT+CLIP, Calling Line Identification Presentation......................................22
4.3.7 AT+CLIR, Calling Line Identification Restriction.........................................22
4.3.8 AT+COLP, Connected Line Identification Presentation..............................23
4.3.9 AT+CCFC, Call Forwarding Number and Conditions.................................23
4.3.10 AT+CCWA, Call Waiting ........................................................................25
4.3.11 AT+CHLD, Call Related Supplementary Services..................................26
4.3.12 AT+CUSD, Unstructured Supplementary Service Data..........................26
4.3.13 AT+CLCC, List Current Calls .................................................................27
4.3.14 AT+CPOL, Preferred Operator List ........................................................28
4.3.15 AT+COPN, Read Operator Names ........................................................28
4.4 Mobile Equipment Control and Status Commands............................................28
4.4.1 AT+CFUN, Set Phone Functionality ..........................................................28
4.4.2 AT+CPIN, Enter PIN..................................................................................29
1. OVERVIEW
UbiNetics produces a range of dual band GSM radio modems, which give compatible
mobile devices wireless connectivity using the GSM900/1800 cellular networks.
The modems are controlled by industry standard AT commands which are defined by
ETSI in GSM 07.07, GSM 07.05, V.25ter and T.32. These may be downloaded from
http://www.etsi.org or http://www.3gpp.org
This application note describes the AT command set supported by UbiNetics for use
with the following modems;
• GDC200 Firmware 1.18.5
• GC201 Firmware 1.18.5
• GA100 Firmware R13.000.01
All other commands not included within this document, whether recognised or not, are
not supported and their use is not guaranteed.
This section contains a list of commonly used definitions and abbreviations which are
used through out this document.
Remote Station
This is the term given to describe the equipment or modem at the other end of the link,
when making a mobile originated or mobile terminated call.
Mobile Station
Through out this document this term refers to the UbiNetics modem.
Syntactical Definitions
The following syntactical definitions are used throughout this document;
<cr> Carriage Return character.
<lf> Line Feed character.
<...> a subparameter enclosed within angle brackets, is a syntactical element. The
brackets themselves do not appear in the command line.
[...] Optional subparameter, is enclosed within square brackets. This indicates the
element may or may not be present within a result code or can be omitted from
the command string. The square brackets themselves do not appear in the
command line.
underline Indicates a default setting of a subparameter value.
Abbreviations
GSM Global System for Mobile communications
AT ATtention, used to start a command line.
CBM Cell Broadcast Message.
SMS Short Message Service.
PIN Personal Identity Number.
DCE Data Connection Equipment, within this document refers to the modem.
DTE Data Terminal Equipment, this refers to the host device/application.
ETSI European Telecommunications Standards Institute.
IMEI International Mobile station Equipment Identity.
ITU-T International Telecommunication Union = Telecommunication
Standardisation Sector.
PDU Protocol Data Unit.
RLP Radio Link Protocol.
SIM Subscriber Identity Module.
TE Terminal Equipment, refers to the host device/application.
TA Terminal Adapter, refers to the modem.
ME Mobile Equipment, refers to the modem.
TIA Telecommunications Industry Association.
TAPI Telephone APplication Interface.
PIN Personal Indentification Number, 4 digit code used to protect the SIM.
PUK Unblocking Key, 8 digit code used to unblock SIM PIN.
In general AT commands comprises of three parts, which start with AT, followed by a
command and ended with the line termination character <cr>. The exceptions to this
are A/ and +++ which are sent without AT and carriage return.
The response from each command varies and is documented within the following text.
In general a successful command will respond with OK, whilst an unrecognised
command will fail with an error. If the command is recognised but fails due to an invalid
subparameter, equipment error or network error, a more informative result code may
be obtained by using the command AT+CMEE=2, to display extended verbose result
codes.
Types of Commands
AT commands have three basic structures, some of which are not applicable to all
command types, for further information see the individual commands.
• Test Commands (ATxxx=?) test's the existence of a command and checks it's
range of subparameter(s). UbiNetics may not support the full range of values
returned by this command.
• Read Commands (ATxxx?) reads the current value of the subparameter(s).
• Set Command (ATxxx=a,b) will attempt to set a new subparameter value(s). If the
command is successful the AT command interpreter will return OK (if ATV1, ATQ0)
otherwise an error or informative result code will be returned.
Command Formatting
Result code(s) that are sent from the modem use the Line Feed character <lf>
appended to a Carriage Return <cr>, to correctly format the text on different lines.
Concatenation
Several commands may be joined together to form a single command string, that must
be no longer than 350 characters (including the line termination character <cr>).
When concatenating commands only one AT is required at the beginning of the string
and one carriage return at the end. In the middle, commands joined together in the
order to be processed. Extended command i.e. ones which start AT+ also require an
additional semi-colon (;). If an error occurs whilst processing the string, the following
commands will not be processed and an error returned. See the examples below;
ATE0V1D123456;<cr>
AT+CMGR=1,2;+CMGR=3,4<cr>
Some AT commands are not suitable for concatenation and careful thought is required
before stringing together many AT commands.
This section covers the AT commands that specified within GSM 07.07 and supported
by the UbiNetics modems.
interworking error
bearer service not available
no TI available
timer 303 expiry
establishment failure
no error
operation failed
timeout
bearer service not compatible
NULL
<n>:
0 disable the result code presentation in the TA
1 enable the result code presentation in the TA
<str>: (string type USSD-string, when <str> parameter is not given, network is not
interrogated)
<dcs>: (Cell Broadcast Data Coding Scheme in integer format)
<m>:
0 no further user action required (network initiated USSD-Notify, or no further
information needed after mobile initiated operation)
This section covers the AT commands that specified within GSM 07.05 and supported
by the UbiNetics modems.
-if <dcs> indicates that GSM 03.38 default alphabet is used and <fo> indicates
that GSM 03.40 TP-User-Data-Header-Indication is not set;
- if TE character set other than "HEX", ME/TA converts GSM alphabet into
current TE character set according to rules
-if <dcs> indicates that 8-bit or UCS2 data coding scheme is used, or <fo>
indicates that GSM 03.40 TP-User-Data-Header-Indication is set: ME/TA
converts each 8-bit octet into two IRA character long hexadecimal number
In the case of CBS: (GSM 03.41) CBM Content of Message in text mode responses;
format:
- if <dcs> indicates that GSM 03.38 default alphabet is used;
- if TE character set other than "HEX", ME/TA converts GSM alphabet into
current TE character set according to rules.
-if <dcs> indicates that 8-bit or UCS2 data coding scheme is used: ME/TA
converts each 8-bit octet into two IRA character long hexadecimal number
<dcs>: (depending on the command or result code: GSM 03.38 SMS Data Coding
Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format
<dt>: (GSM 03.40 TP-Discharge-Time in time-string format: “yy/MM/dd,hh:mm:ss±zz”
where characters indicate year (two last digits), month, day, hour, minutes,
seconds and time zone. e.g. 6th of May 1994, 22:10:00 GMT+2 hours equals to
“94/05/06,22:10:00+08”)
<fo>: (depending on the command or result code: first octet of GSM 03.40 SMS-
DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-
COMMAND (default 2) in integer format)
<length>: (integer type value indicating in the text mode (AT+CMGF=1) the length of
the message body <data> (or <cdata>) in characters; or in PDU mode
(AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer
SMSC address octets are not counted in the length))
<mid>: (GSM 03.41 CBM Message Identifier in integer format)
<mn>: (GSM 03.40 TP-Message-Number in integer format)
<mr>: (GSM 03.40 TP-Message-Reference in integer format, returned to the TE on
successful message delivery)
<oa>: (GSM 03.40 TP-Originating-Address Address-Value field in string format; BCD
numbers (or GSM default alphabet characters) are converted to characters of the
currently selected TE character set, type of address given by <tooa>)
<page>: (GSM 03.41 CBM Page Parameter bits 4-7 in integer format)
<pages>: (GSM 03.41 CBM Page Parameter bits 0-3 in integer format)
<pdu>: (In the case of SMS: GSM 04.11 SC address followed by GSM 03.40 TPDU in
hexadecimal format: ME/TA converts each octet of TP data unit into two IRA
character long hexadecimal number (e.g. octet with integer value 42 is presented
to TE as two characters 2A (IRA 50 and 65)))
In the case of CBS: GSM 03.41 TPDU in hexadecimal format
<pid>: (GSM 03.40 TP-Protocol-Identifier in integer format)
<ra>: (GSM 03.40 TP-Recipient-Address Address-Value field in string format; BCD
numbers (or GSM default alphabet characters) are converted to characters of the
currently selected TE character set type of address given by <tora>)
<sca>: (GSM 04.11, Service Centre Address, in format <tosca>)
<scts>: (GSM 03.40 TP-Service-Centre-Time-Stamp in time-string format
<sn>: (GSM 03.41 CBM Serial Number in integer format)
<st>: (GSM 03.40 TP-Status in integer format)
<toda>: (GSM 04.11 TP-Destination-Address Type-of-Address octet in integer format
(when first character of <da> is + (IRA 43) default is 145, otherwise default is
129))
<tooa>: (GSM 04.11 TP-Originating-Address Type-of-Address octet in integer format
(default refer <toda>))
<tora>: (GSM 04.11 TP-Recipient-Address Type-of-Address octet in integer format
(default refer <toda>))
<tosca>: (type of Service Centre Address, 129 for normal dial string, 145 for
international access (number which contains '+' character))
<vp>: (depending on SMS-SUBMIT <fo> setting: GSM 03.40 TP-Validity-Period either
in integer format (default 167), in time-string format refer <dt>)
1 type supported
BT Cellnet +447802000332
Vodafone +447785016005
Orange +447973100973
One 2 One +447958879879
Virgin +447958879890
If text mode;
+CBM: <sn>,<mid>,<dcs>,<page>,
<pages> <cr><lf><data>
+CMGL: <index>,<stat>,<oa/da>,[<alpha>],[<scts>][,<tooa/
toda>,<length>]<cr><lf><data>[<cr><lf>
+CMGL: <index>,<stat>,<da/oa>,[<alpha>],[<scts>]
[,<tooa/toda>, <length>]<cr><lf><data>[...]]
+CMGL: <index>,<stat>,[<alpha>],<length>
<cr><lf><pdu>[<cr><lf>
+CMGL:<index>,<stat>,[<alpha>],<length><cr><lf><pdu>[...]]
+CMGR: <stat>,<oa>,[<alpha>],<scts>[,<tooa>,<fo>,<pid>,
<dcs>,<sca>,<tosca>,<length>]<cr><lf><data>
+CMGR: <stat>,<da>,[<alpha>][,<toda>,<fo>,<pid>,
<dcs>,[<vp>],<sca>,<tosca>,<length>]<cr><lf><data>
Note:
1. Control+z = terminate and send, escape = terminate and quit (without sending).
2. After sending the command AT+CMGS="123456"<cr> wait for the character >
before sending the text or characters will be lost.
3. The text string is terminated by ctrl+z do not use a carriage return like other
commands.
If PDU mode;
AT+CMGW=<length>[,<stat>]<cr>
PDU is given<ctrl+z>
Note:
1. Control+z = terminate and write, escape = terminate and quit (without writing).
2. After sending the command AT+CMGW="123456"<cr> wait for the character >
before sending the text or characters will be lost.
3. The text string is terminated by ctrl+z do not use carriage return like other
commands.
This section covers the AT commands specified within ITU-T, V.25ter referenced by
GSM 07.07.
6.1.1 +++, Changes from Online Data mode to Online Command mode
This command changes the modem from online data mode to online command mode,
whilst still retaining the data call. No AT or line termination is required.
ATI[0] 14400
ATI1 Ubinetics Ltd.
ATI2 Ubinetics Ltd.
ATI3 1.18.5 (the software version)
ATI4 Ubinetics Ltd.
ATI5 Dual Band PC Card
ATI6 Designed in UK
For the GA100.
ATI[0] 14400
ATI1 Ubinetics Ltd.
ATI2 Ubinetics Ltd.
ATI3 R13 (the software version)
ATI4 Ubinetics Ltd.
25/01/01 1.18.5
25/01/01 1.18.5
This section lists the typical result codes seen from the Mobile Equipment and
Message Service, in both numeric and verbose formats.
0 phone failure
1 no connection to phone
2 phone-adaptor link reserved
3 operation not allowed
4 operation not supported
5 PH-SIM PIN required
6 PH-FSIM PIN required
7 PH-FSIM PUK required
10 SIM not inserted
11 SIM PIN required
12 SIM PUK required
13 SIM failure
14 SIM busy
15 SIM wrong
16 Incorrect password
17 SIM PIN2 required
18 SIM PUK2 required
20 memory full
21 invalid index
22 not found
23 memory failure
24 text string too long
25 invalid characters in text string
26 dial string too long
27 invalid characters in dial string
30 no network service
31 network timeout
32 network not allowed - emergency calls only
40 network personalisation PIN required
41 network personalisation PUK required
42 network subset personalisation PIN required
43 network subset personalisation PUK required
ã UbiNetics 2001 Page 56 of 60
Application Note AN010 GSM AT Command Set
9. REFERENCES
GSM 07.07 (ETS 300 916): February 1998 (GSM 07.07 version 5.5.0) AT command
set for GSM Mobile Equipment (ME).
GSM 07.05 (GTS 07.05): January 1998 (GSM 07.05 version 5.5.0) Use of data
Terminal Equipment - Data Circuit terminating equipment (DTE-DCE) interface for
Short Message Service (SMS) and Cell Broadcast Service (CBS), ETSI.
T.32 (T.32 08/95) Asynchronous facsimile DCE control - service class 2, ITU
V.25ter (ITU-T V.25 ter, 1997) ITU-T Recommendation V.25ter; series V: data
communication over the telephone network; Interfaces and voiceband modems; Serial
asynchronous automatic dialling and control, ITU.
GSM 03.40 (ETS 300 901): "Digital cellular telecommunications system (Phase 2+);
Technical realization of the Short Message Service (SMS) Point-to-Point (PP)".
GSM 04.11 (ETS 300 942): "Digital cellular telecommunications system (Phase 2+);
Point-to-Point (PP) Short Message Service (SMS) support on mobile radio interface".
GSM 03.38 (ETS 300 900): "Digital cellular telecommunications system (Phase 2+);
Alphabets and language-specific information".
GSM 03.41 (ETS 300 902): "Digital cellular telecommunications system (Phase 2+);
Technical realization of Short Message Service Cell Broadcast (SMSCB)".