Novatel MT 3050 Installation manual

GSM2378AT001
MT 3050
ATCommand Reference
Version: 1.0215 August, 2014

-i-
General
TERMS OF USE OF NEW MATERIALS - PLEASE READ CAREFULLY
From time to time, Novatel Wireless, in its sole discretion, may make available for download on its website
(www.novatelwireless.com), or may transmit via mail or email, updates or upgrades to, or new releases of, the firmware,
software or documentation for its products (collectively, 'New Materials'). Use of such New Materials is subject to the terms
and conditions set forth below, and may be subject to additional terms and conditions as set forth in Novatel Wireless's
Technical Support Policy (posted on its website) and/or any written agreement between the user and Novatel Wireless.
All New Materials are provided AS IS. Novatel Wireless makes no warranty or representation with respect to the
merchantability, suitability, functionality, accuracy or completeness of any such New Materials. The user of such New
Materials assumes all risk (known or unknown) of such use. Novatel Wireless reserves all rights in such New Materials. The user
shall have only a revocable and limited license to use such New Materials in connection with the products for which they are
intended. Distribution or modification of any New Materials without Novatel Wireless's consent is strictly prohibited.
IN NO EVENT WILL NOVATEL WIRELESS BE RESPONSIBLE FOR ANY INCIDENTAL, INDIRECT, CONSEQUENTIAL OR SPECIAL
DAMAGES AS A RESULT OF THE USE OF ANY NEW MATERIALS. NOVATEL WIRELESS'S MAXIMUM LIABILITY FOR ANY CLAIM
BASED ON THE NEW MATERIALS SHALL NOT EXCEED FIFTY U.S. DOLLARS ($50).
Version Verification
Please ensure you have the latest version of this document by downloading it from www.novatelwireless.com

-ii -
Copyright
© 2013 Novatel Wireless. All rights reserved. Complying with all applicable copyright laws is the responsibility of the user.
Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a
retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording or otherwise),
or for any purpose, without the express written permission of Novatel Wireless.
Novatel Wireless and the Novatel Wireless logo are either registered trademarks or trademarks of Novatel Wireless. in the
United States.
251 Renner Pkwy
Richardson, TX 75080 USA
Phone: [phone]
Fax: [phone]
Email: [e-mail]
www.novatelwireless.com

-iii -
Table of Contents
Introduction 1
Document Scope 2
Platform Reference And Use 2
Command Syntax 3
Standard AT Commands 4
General Commands 5
AT$PKG Request Firmware Package 6
AT+CGMI Request Manufacturer Identification 8
AT+CGMM Request Manufacturer Model Identification 9
AT+CGMR Request Revision Identification 10
AT+CGSN Request IMEI 11
AT+GMI TA Manufacturer ID 12
AT+GMM TA Model ID 13
AT+GMR TA Revision Number 14
AT+GSN TA Serial Number 15
AT+WS46 Select Wireless Network 16
ATI Manufacturer Information About TA 17
METACommands 18
AT$HBRST Automatic Modem Reset 19
AT&F Set All TA Parameters To Factory Defined Configuration 21
AT&V Display Current Profile 22
AT&W Save Current Settings 23
AT+CEER Extended Error Reporting 24
AT+CFUN Set Phone Functionality 26
AT+CMEE Report Mobile Equipment Errors 27

-iv -
AT+CPIN Enter PIN 28
AT+CPUC Price Per Unit And Currency Table 30
AT+CRES Restore Settings 31
AT+CSAS Save Settings 32
AT+CSCS Select TE Character Set 33
AT+CSTA Select Type Of Address 34
AT+FCLASS GSM Class Of Service 35
AT+GCAP Request Overall Capabilities For TA 36
ATE Command Echo Mode 37
ATQ Result Code Suppression 38
ATS3 Command Line Termination Character 39
ATS4 Response Formatting Character 40
ATS5 Editing Character 41
ATV Response Format 42
ATX CONNECT Result 43
ATZ Set All TA Parameters To Default Configuration 44
Call Control Commands 45
ATD Dial Command 46
ATH Hook Control 48
H Manual Rejection Of A Network Request For PDP Context Activation 49
Network Service Commands 50
AT+CIMI Request IMSI 51
AT+CLCK Facility Lock 52
AT+CLCKCFG Set Facility Lock Configuration 55
AT+CLCKCP Set Corporate Personalization Lock 56
AT+CLCKSP Set Provider Personalization Lock 57
AT+CNUM Subscriber Number 59
AT+COPN Read Operator Names 60

-v-
AT+COPS Operator Selection 61
AT+CPOL Preferred Operator List 63
AT+CPOL Preferred PLMN List 64
AT+CSQ Signal Quality And Bit Error Rate 66
AT+CRLP Radio Link Protocol Parameters 69
Supplementary Service Commands 70
AT+CSSN Supplementary Service Notifications 71
AT+CUSD Unstructured Supplementary Service 73
SMS Commands 75
AT$QCMSS Send Message From Storage 76
AT$QCMGD Delete Message 77
AT$QCMGF SMS Format 78
AT$QCMGL List Messages 79
AT$QCMGR Read Message 81
AT$QCMGS Send Message 82
AT$QCMGW Write Message To Memory 83
AT$QCNMI New Message Indications To TE 84
AT$QCPMS Preferred Message Storage 85
AT$QCSMP Set Text Mode Parameters 86
AT$SMSURC Enable URC To Be Sent By SMS 87
AT+CMGF SMS Format 88
AT+CMGD Delete Message 89
AT+CMGL List Messages 90
AT+CMGR Read Message 92
AT+CMGS Send Message 93
AT+CMGW Write Message To Memory 94
AT+CMSS Send Message From Storage 95
AT+CNMI New Message Indication To TE 96

-vi -
AT+CPMS Preferred Message Storage 98
3GPPP Commands 99
AT+CGACT PDP Context Activate Or Deactivate 100
AT+CGANS Manual Response To A Network Request For PDP Context Activation 101
AT+CGATT Data Service Attach Or Detach 102
AT+CGAUTO Automatic Response To A Network Request For PDP Context Activation 103
AT+CGCLASS GPRS Mobile Station Class 104
AT+CGDCONT Define PDP Context 105
AT+CGEREP Data Service Event Reporting 107
AT+CGEV Deactivation Indication Reporting 108
AT+CGPADDR Show PDP Address 109
AT+CGQMIN Quality Of Service Profile (Minimum Acceptable) 110
AT+CGREQ Quality Of Service 111
AT+CGSMS Select Service For MO SMS Messages 113
AT%CGPCO Set Type Of Authentication, Username And Password 114
AT%CGPPP Negotiation Selection 116
ATD Request GPRS Service 117
IPRouter Commands 118
AT$FLFILT Filter ICMP Echo Request 119
AT$GATEWAY Gateway IP 120
AT$NETIP Display Network Assigned IP & DNS 121
AT$PING Send ICMP Echo Request 122
Message Commands 123
AT$APIOPT Enable API Optional Header Fields 124
AT$APIPWD API Password 127
AT$ATPASSWD Set Authorization For AT Commands For Serial, SMS And API 128
AT$CHKIN Configure Device Check-in 130

-vii -
AT$FRIEND Modem Friends 132
AT$MDMID Modem ID 134
AT$MLQSIZ Message Log Queue Size 135
AT$MSGLOGCL Message Log Clear 137
AT$MSGLOGDMP Dump Unsent Messages To Serial Port 138
AT$MSGLOGEN Message Log Enable 140
AT$MSGLOGRD Message Log Read Data 141
AT$MSGSND Message Send 143
AT$SMSDA Destination Address For SMS Messages 145
AT$SMSDAEN Enable/Disable ATCommands Over SMS 147
AT$SNDMSG Send Test Message 148
AT$UDPMSG Send And Receive UDP Messages 149
AT$WAKEUP Modem To Server Wakeup/Keep Alive 151
AT%SNCNT Query (or Reset) The Byte Counters (GPRS Only) 153
API Commands 154
TCP API Commands 155
AT$TCPAPI TCP API Control 155
AT$TCPIDLETO TCP API Idle Timeout 157
AT$TCPRESTRT TCP API Restart 158
AT$TCPRETRYTO TCP API Retry Timeout 159
AT$TCPSRC TCP API Source Ports 160
AT$TCPSTATS TCP API Statistics 161
AT$TCPURC Enable URC Over TCP API 162
UDP API Commands 163
AT$ACKTM Acknowledgment Message Period & Retry Number 163
AT$UDPAPI Modem API Address 165
FOTA Commands 166
AT$FOTACFG Configure Firmware Upgrade 167

-viii -
AT$FOTAGET Get Firmware Upgrade OTA 169
AT$FOTAUPG Upgrade Current Firmware 171
FTP Commands 172
AT$ATEXEC Execute AT Command File 173
AT$FFS Generic Flash File System Access 175
AT$FTPABORT Aborts Current Data Operation With FTP Server 178
AT$FTPBLK Change Current FTP BLock Size 179
AT$FTPCFG Configure FTP Parameters 180
AT$FTPCHDIR Change Current Working Directory 181
AT$FTPCLOSE Closes The Connection To The FTP Server 182
AT$FTPDIR Directory Listing 183
AT$FTPGET Retrieve A Remote File 184
AT$FTPOPEN Opens FTP Connection 185
AT$FTPPUT Store A Local File On The FTP Server 186
AT$FTPR Outputs Block Of File Data Onto Serial Port 187
AT$FTPRST Restart The Last FTP GET Operation 188
RTC Commands 189
AT$RTCALRM Real Time Clock Alarm 190
AT$RTCCLRA Real Time Clock Clear Alarm 192
AT$RTCRSET RTC Report Reset State 193
AT$RTCTIME Real Time Clock Time 194
AT$RTCWAKE Real Time Alarm Wake 196
Miscellaneous Commands 197
AT$AREG Auto Registration 198
AT$CREG Network Registration Info 200
AT$NETMON Monitor Network Availability 201
AT+CBST Select Bearer Service Type 203

-ix -
AT%CGREG GPRS Extended Registration State 205
AT+CLCK Facility Lock 207
AT+CLIP Calling Line Identification Presentation 210
AT+CNUM Subscriber Number 212
AT+COLP Connected Line Identification 213
AT+COPN Read Operator Names 214
AT+COPS Operator Selection 215
AT+CPIN Enter PIN 217
AT+CPLS Selection Of Preferred PLMN List 219
AT+CPOL Preferred Operator List 220
AT+CPWD Change Password 221
AT+CR -Service Reporting Control 223
AT+CREG Network Registration Info 224
AT+CRLP Radio Link Protocol Parameters 226
AT+CSQ Signal Quality And Bit Error Rate 227
Event Commands 230
AT$ETSAV# Event Timer Save Configuration 231
AT$EVCID User Defined Incoming Call Number Event 232
AT$EVDEL Delete Event 234
AT$EVDELA Delete Event (All) 235
AT$EVDELR Delete A Range Of Event Groups 236
AT$EVENT User Defined Input/Output 237
AT$EVGQRY Event Group Query 239
AT$EVNTRY Event Count Query 240
AT$EVTEST Generate Test Input Event 241
AT$EVTIM# User Defined Input Event Timers 242
AT$EVTIMQRY Event Counter 243
AT$EVTOFF Event Engine Disable 244

-x-
AT$EVTQRY Query The State Or Value Of The Specified Input Event 245
AT$STOATEV Store AT Command Events 246
AT$USRVAL User Value 248
Miscellaneous Commands 249
AT$ICCID Integrated Circuit Card ID 250
AT$IGNDBNC Debounce Ignition Hardware Line For The Specified Amount Of Time 251
AT$MDSTAT Query Modem Status 252
AT$OFF Power Off Command 256
AT%CSTAT Unsolicited SIM Status 257
AT%EM Engineering Mode 258
AT%MEPD MEPD Configuration Data 259
AT%SIMIND SIM Status Indication 261
AT%SLEEP Select Level Of Sleep Mode 263
AT+CPWD Change Password 265
Battery Commands 267
AT$OBDBAT Enable/Disable Backup Battery 268
AT$OBDBBT Backup Battery Timer 270
AT$OBDBQS Backup Battery Quick Shutdown 271
OBD Commands 272
AT$OBDACL Acceleration Thresholds 273
AT$OBDADN Set Down Accelerometer Threshold 274
AT$OBDADT Auto Discovery Timer 275
AT$OBDALT Set Left Turn Accelerometer Threshold 276
AT$OBDAM Set Any Motion Parameters 277
AT$OBDART Set Right Turn Threshold 278
AT$OBDAUP OBD2 Set Up Accelerometer Threshold 279
AT$OBDBAT Enable/Disable Backup Battery 280

-xi -
AT$OBDBBT Backup Battery Timer 281
AT$OBDBQS Backup Battery Quick Shutdown 282
AT$OBDCUT Clear The OBD2 User Trip Odometer 283
AT$OBDDCL Deceleration Thresholds 284
AT$OBDDSC Discovery Configuration 285
AT$OBDECT Engine Coolant Temperature Threshold 286
AT$OBDEES Excessive Engine Speed Thresholds 287
AT$OBDFAC Set Thresholds To Factory Defaults 288
AT$OBDGSP Use OBD Speed In Place Of GPS Speed 289
AT$OBDIDL Idle Speed Threshold 290
AT$OBDIGN OBD2 Ignition Off Configuration 291
AT$OBDLBL Low Battery Level Threshold 292
AT$OBDLED OBD2 LED Timer 293
AT$OBDLFL Low Fuel Level Threshold 294
AT$OBDSAV Save OBDII Thresholds To Memory 295
AT$OBDSPD Vehicle Speed Thresholds 296
AT$OBDTYP Protocol Type 297
AT$OBDVER Auxiliary Processor 299
GPS Commands 300
AT$ALTOSI Set And Query GPS Overspeed Interval 301
AT$EXCACC Excessive Acceleration 302
AT$EXCDEC Excessive Deceleration 303
AT$GEOFNC Geo Fencing A Circular Area 304
AT$GFDBNC Set Geofence Debounce Count 305
AT$GFDEL Delete A Range Of Geo-Fences 306
AT$GPSCMD GPS Command 307
AT$GPSFD Restore GPS Filter Defaults 308
AT$GPSFLT GPS Speed Filter 309

-xii -
AT$GPSLCL Configure Sending Of GPS Message To The Serial Port 314
AT$GPSLNA Enable/Disable Internal LNA 316
AT$GPSOSI Set And Query GPS Overspeed Interval 317
AT$GPSQUAL GPS Quality Filters 318
AT$GPSRD Read Current GPS ASCII Data 320
AT$GPSRST Set And Query GPS Reset Interval 322
AT$GPSVAL GPS Speed Validation 324
AT$ODOCFG Thresholds For Odometer/Speed Filtering 325
AT$ODOMETER GPS Trip Odometer 326
AT$PLYCLR Clear Polygonal Geofence 327
AT$PLYFN# Geo Fencing A Polygonal Area 328
AT$PWRSAV Enable Power Save Mode 331
AT$TODOM Virtual Trip Odometer 332
AT$GPSDIS Disable GPS Functionality 334
Event Tables 335
Event Engine 336
Event Category 336
Event Type 336
Input Event Table 340
Output Event Table 347
User Variable Index Table 350
GPIO Flash Table 360
Bit Field Tables 361
Bit-Field Table Selection 361
Bit-Field Table 0 – Legacy (0,0) 361
Bit-Field Table 2 – (1,0) 364
OBD Bit Field Tables 369
OBD BIT-FIELD TABLE SELECTION 369

-xiii -
BIT-FIELD TABLE 0 – OBD (0,0) 369
OBD Parm 3 BIT-FIELD TABLE – Parm 3 Bank 1 372
Appendix - Result Codes 373
Result Codes 374
UNSOLICITED RESULT Codes 374
SMS Unsolicited Result Codes 375
Appendix - Error Codes 376
General Error Codes 377
Network Error Codes 378
SMS Error Codes (+CMS) 380
Release Causes For Extended Error Reporting (+CEER) 383
Extended Error Codes 385
Index 386

-1-
Introduction

-2-
Document Scope
The following documentation pertains to the AT Command Set to be used in conjunction with the Novatel
Wireless Device identified in the title of this document.
Platform Reference And Use
The device will be referred to using various terms, to include: MS (Mobile Station), TA (Terminal Adapter), DCE
(Data Communication Equipment), or ME (Mobile Equipment).
The device can be controlled via the use of a DTE (Data Terminal Equipment) platform by issuing the AT
commands via a serial interface.

-3-
Command Syntax
The attention or “AT” prefix is required prior to entering any command. All commands require a carriage return or
<CR> following the entry of the desired command. All command responses are encapsulated by a carriage return
and line feed or <CR><LF>. The ASCII display of these characters is suppressed with only the modem response
being presented.
In addition to terminating AT commands, the carriage return <CR> is also used to abort commands that are
executing.
Most AT commands complete immediately so there is no opportunity to abort them, for instance ATI. However,
Some commands like AT+COPS or AT+CFUN can actually take several seconds to complete. The AT command
interface is said to be in execution mode when a command is running and has not returned a result code
(OK/ERROR). A second <CR> entered while the AT command interface is in execution mode will abort the
command and return the interface to command mode.
Some AT commands require additional input, for instance AT+CMGS. After terminating the AT+CMGS command
with a <CR> the AT command interface enters line edit mode. While in line edit mode all characters are accepted
except CNTL-Z. CNTL-Z terminates line edit mode and the AT command interface enters execution mode. Like
before, at this point another <CR> will abort the command.
AT message concatenation can be done using the ; <semicolon> between commands.
The following examples demonstrate the potential usage of AT commands presented:
Type Example Description
Syntax Query AT+GXXX=? When entered will return the command format and value ranges.
Read Syntax AT+GXXX? When entered will return the current value assigned to the command.
Write Syntax AT+GXXX=<value>,<value>, When entered will set the command to specified value(s).
Execute Syntax AT+GXXX When entered will execute the specified command.
Command Concatenation AT+CRC=1;S0=1 When entered it will execute both the CRC and S0 command.

-4-
Standard AT Commands
The following is the format in which all commands will be presented.
ATx(Command) Xxxxx (Command Description)
Command Function (Description of the command function)
Syntax Query ATx=?
Syntax ATx: (parameter1 name 1 – 15), (parameter2 name 1-10),…
Write Syntax ATx=<value>,<value>[,<optional value>],…
Write Response OK or ERROR
Read Syntax ATx?
Read Response <value>,<value>,…
Execute Syntax ATx
Execute Response OK, ERROR, or <value>
Unsolicited Response
Parameter Values
<Value 1> ATx: (1-15),(1-10)
<Value 2>
Notes (Additional command notes)
Examples
Where applicable, the <value> responses provided for the READ and EXECUTE formats are
modem default values. All efforts will be made by Novatel Wireless. to keep these values current
in the documentation but will not be responsible for any differences that may occur as a result
subsequent software builds and version enhancements.
Do not use tab characters in the custom AT command scripts.

-5-
General Commands

-6-
AT$PKG Request Firmware Package
AT$PKG Request Firmware Package
Command Function This command is used to obtain the firmware package version.
Syntax Query N/A
Syntax N/A
Write Syntax N/A
Write Response N/A
Read Syntax N/A
Read Response N/A
Execute Syntax AT$PKG
Execute Response <baseline release>-<release offset>
OK
Unsolicited Response N/A
Parameter Values
<baseline release> 1 to 99 - number associated with official production release