Novatel USB730L User Manual

Global Modem USB730L
AT Command Reference Guide
Version 1.2 Aug 09, 2017
USB730L – AT002
©2017 Novatel Wireless, Inc. All rights reserved. The information contained in this document is subject to change without notice and should not be construed as a commitment by Novatel Wireless, Inc.
NOVATEL WIRELESS TRADEMARKS AND SERVICE MARKS
Novatel Wireless is a trademark of Novatel Wireless, Inc., and the other trademarks, logos, and service marks (collectively the “Trademarks”) used in this user manual are the property of Novatel Wireless or their respective owners. Nothing contained in this user manual should be construed as granting by implication, estoppel, or otherwise, a license or right of use of Novatel Wireless or any other Trademark displayed in this user manual without the written permission of Novatel Wireless or its respective owners.
Novatel Wireless, and the Novatel Wireless logo are all trademarks of Novatel Wireless,
USB730L AT Command Reference Guide 3
General Disclaimer
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
To ensure you have the latest version of this document, visit Verizon Wireless support site at
https://www.verizonwireless.com/support/verizon-global-usb-modem-usb730l/.
USB730L AT Command Reference Guide 4
Contents
Introduction ...................................................................................................................... 7
AT Command Format ................................................................................................................................ 9
NVTL AT Commands ..................................................................................................... 10
AT$CNTI .................................................................................................................................................... 11
AT$NWATI ................................................................................................................................................. 12
AT$NWATR ............................................................................................................................................... 14
AT$NWBAND ............................................................................................................................................ 15
AT$NWBAND2 .......................................................................................................................................... 17
AT$NWCCMAUTOCONNECT ..................................................................................................................... 19
AT$NWCCMCONNECT .............................................................................................................................. 20
AT$NWCFT ................................................................................................................................................ 21
AT$NWCHBAND ........................................................................................................................................ 22
AT$NWCID ................................................................................................................................................ 23
AT$NWCSLFILTER...................................................................................................................................... 24
AT$NWDATAUSAGE .................................................................................................................................. 25
AT$NWDEGC ............................................................................................................................................. 26
AT$NWDYNAMICSTATUS .......................................................................................................................... 27
AT$NWFID ................................................................................................................................................. 28
AT$NWFOTASTATUS ................................................................................................................................. 29
AT$NWFWAPIVER ..................................................................................................................................... 30
AT$NWHWID ............................................................................................................................................ 31
AT$NWICCID .............................................................................................................................................. 32
AT$NWLTIME ............................................................................................................................................ 33
AT$NWMCCFILTER .................................................................................................................................... 34
AT$NWMDN.............................................................................................................................................. 35
AT$NWMFG .............................................................................................................................................. 36
AT$NWMIFIOSSTATUS .............................................................................................................................. 37
AT$NWNITZ ............................................................................................................................................... 38
AT$NWNN ................................................................................................................................................. 39
AT$NWPINR .............................................................................................................................................. 40
AT$NWPREFMODE .................................................................................................................................... 41
AT$NWPRI ................................................................................................................................................. 42
AT$NWRAT................................................................................................................................................ 43
USB730L AT Command Reference Guide 5
AT$NWSFEUIMID ...................................................................................................................................... 45
AT$NWSIMCAP ......................................................................................................................................... 46
AT$NWSMSIMSFORMAT ........................................................................................................................... 47
AT$NWSTATICSTATUS ............................................................................................................................... 48
AT$NWSVN ............................................................................................................................................... 49
AT$NWTHERMTEMP ................................................................................................................................ 50
AT$NWTIMESINCEBOOTUP ...................................................................................................................... 51
AT+ICCID .................................................................................................................................................... 52
AT+VZWMRUC .......................................................................................................................................... 53
AT+VZWMRUE .......................................................................................................................................... 54
AT+VZWRSRP ............................................................................................................................................ 56
AT+VZWRSRQ ............................................................................................................................................ 57
3GPP AT Commands ..................................................................................................... 58
AT+CCLK .................................................................................................................................................... 59
AT+CEER .................................................................................................................................................... 60
AT+CEMODE .............................................................................................................................................. 61
AT+CEREG ................................................................................................................................................. 62
AT+CFUN ................................................................................................................................................... 63
AT+CGACT ................................................................................................................................................. 64
AT+CGCMOD ............................................................................................................................................. 65
AT+CGDCONT ............................................................................................................................................ 66
AT+CGDSCONT .......................................................................................................................................... 67
AT+CGEQOSRDP ........................................................................................................................................ 68
AT+CGEREP ............................................................................................................................................... 69
AT+CGMI ................................................................................................................................................... 70
AT+CGMM ................................................................................................................................................. 71
AT+CGMR .................................................................................................................................................. 72
AT+CGPADDR ............................................................................................................................................ 73
AT+CGPIAF ................................................................................................................................................ 74
AT+CGREG ................................................................................................................................................. 75
AT+CGSMS ................................................................................................................................................ 76
AT+CGSN ................................................................................................................................................... 77
AT+CGTFT .................................................................................................................................................. 78
AT+CGTFTRDP ............................................................................................................................................ 79
AT+CIMI ..................................................................................................................................................... 80
AT+CIND .................................................................................................................................................... 81
USB730L AT Command Reference Guide 6
AT+CLAC .................................................................................................................................................... 82
AT+CMEC .................................................................................................................................................. 83
AT+CMEE ................................................................................................................................................... 84
AT+CMER .................................................................................................................................................. 85
AT+CMGD .................................................................................................................................................. 86
AT+CMGF .................................................................................................................................................. 87
AT+CMGL .................................................................................................................................................. 88
AT+CMGR .................................................................................................................................................. 89
AT+CMGS .................................................................................................................................................. 90
AT+CMGW ................................................................................................................................................. 91
AT+CMSS ................................................................................................................................................... 92
AT+CNUM.................................................................................................................................................. 93
AT+COPN ................................................................................................................................................... 94
AT+COPS.................................................................................................................................................... 95
AT+CPAS .................................................................................................................................................... 97
AT+CPIN..................................................................................................................................................... 98
AT+CPMS ................................................................................................................................................... 99
AT+CPWD ................................................................................................................................................ 100
AT+CRSM ................................................................................................................................................. 102
AT+CSCA .................................................................................................................................................. 103
AT+CSCS .................................................................................................................................................. 104
AT+CSIM .................................................................................................................................................. 105
AT+CSMP ................................................................................................................................................. 106
AT+CSMS ................................................................................................................................................. 107
AT+CSQ ................................................................................................................................................... 108
AT+CSS .................................................................................................................................................... 109
AT+CSTF .................................................................................................................................................. 110
AT+GCATT ............................................................................................................................................... 111
AT+WS46 ................................................................................................................................................. 112
VZW AT Commands ..................................................................................................... 113
AT+VZWRSRP .......................................................................................................................................... 114
AT+VZWRSRQ .......................................................................................................................................... 115
USB730L AT Command Reference Guide 7
1
Introduction
This document lists and describes the AT Command Set to be used in conjunction with the Novatel Wireless Global Modem USB730L.
Platform Reference and Use
In this document, the device may be referred to using various terms, such as MS (Mobile Station), TA (Terminal Adapter), DCE (Data Communication Equipment), or ME (Mobile Equipment). You can control the device on a DTE (Data Terminal Equipment) platform by issuing the AT commands through a serial interface.
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 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, you can use the carriage return <CR> 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 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 aborts the command and returns 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> aborts the command.
USB730L AT Command Reference Guide 8
You can concatenate an AT message using the semicolon (;) between commands. The following examples demonstrate the potential usage of AT commands presented:
Type
Example
Description
Command Format Query
AT+GXXX=?
Returns the command format and value ranges.
Command Read
AT+GXXX?
Returns the current value assigned to the command.
Command Write
AT+GXXX=<value>,<value>,
Sets the command to specified value(s).
Command Execution
AT+GXXX
Executes the specified command.
Command Concatenation
AT+CRC=1;S0=1
Executes both the CRC and S0 command.
USB730L AT Command Reference Guide 9
AT Command Format
The following is the format in which all commands will be presented.
Command Function
(Description of the command function)
Query Syntax
ATx=?
Query Response
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
NOTE: 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.
WARNING! Do not use tab characters in the custom AT command scripts.
USB730L AT Command Reference Guide 10
2
NVTL AT Commands
USB730L AT Command Reference Guide 11
AT$CNTI
Command
AT$CNTI
Command Function
Queries the current network technology.
Query Syntax
AT$CNTI=?
Query Response
CNTI: (0-2)
Write Syntax
Write Response
Read Syntax
AT$CNTI?
Read Response
$CNTI: 0, LTE $CNTI: 1, LTE $CNTI: 2, GSM, GPRS, EDGE, UMTS, HSDPA, HSUPA, HSPA+, HSPA+DC, LTE, 1xRTT, EVDO, EVDO_REL_0, EVDO_REL_A, EVDO_REL_B
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
0 - <current network access technology
network access technologies have the following values: GPRS – GPRS network
EDGE – Edge network UMTS – UMTS network HSDPA – HSDPA network HSUPA – HSUPA network HSPA+ – HSPA Plus HSPA+DC – HSPA plus DC
Notes
Examples
USB730L AT Command Reference Guide 12
AT$NWATI
Command
AT$NWATI
Command Function
Queries the superset of the ATI command and adds some more info to that AT command.
Query Syntax
AT$NWATI=?
Query Response
Manufacturer: Novatel Wireless Incorporated Model: USB730L Revision: 2.03+ SVN 0 [Feb 4 2014 13:56:48] (Engineering Build - FW123_) SVN: 00 +GCAP: +CLTE1, +CIS707-A, +MS, +ES, +DS VID:PID:RID: 0x1410:0xb00d MEID:0x99000062989008 ESN:0x80226577 HWREV:0 MSISDN:+ IMSI:311480083505147
OK
Write Syntax
Write Response
Read Syntax
Read Response
Execute Syntax
Execute Response
Unsolicited Response
USB730L AT Command Reference Guide 13
Parameter Values
Response: Manufacturer: Model: Revision: SVN: +GCAP: VID:PID:RID: MEID: ESN: HWREV: FID: MSISDN: IMSI:
Notes
Examples
USB730L AT Command Reference Guide 14
AT$NWATR
Command
AT$NWATR
Command Function
Reads the ATR (answer-to-reset) string from the SIM. Used for the AT+CSIM to determine the capabilities of the SIM (used by the application
Query Syntax
AT$NWATR=?
Query Response
$NWATR: <length>, <atr_string>
Write Syntax
Write Response
Read Syntax
AT$NWATR?
Read Response
$NWATR: 23,3b9f97c00a1fc78031e073fe211b65d0011009228100f2
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
<length>
<atr_string>
Notes
Examples
USB730L AT Command Reference Guide 15
AT$NWBAND
Command
AT$NWBAND
Command Function
Reads the band preference. The band preference returned is read from NV item’s NV_BAND_PREF_I and NV_BAND_PREF_16_31_I
Query Syntax
AT$NWBAND=?
Query Response
<band> bit definitions
Write Syntax
=<band_pref>
Write Response
Read Syntax
AT$NWBAND?
Read Response
4e80187
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
<band_pref>
This is a 32-bit hexadecimal value that has the bits set for each band that needs to be enabled. Refer to the query operation for the meaning of each bit.
USB730L AT Command Reference Guide 16
<band>
1 CDMA2000 Band Class 0, A-System 2 CDMA2000 Band Class 0, B-System 02 CDMA2000 Band Class 1, all blocks 03 CDMA2000 Band Class 2 place holder 04 CDMA2000 Band Class 3, A-System 05 CDMA2000 Band Class 4, all blocks 06 CDMA2000 Band Class 5, all blocks 07 GSM DCS band 08 GSM Extended GSM (E-GSM) band 09 GSM Primary GSM (P-GSM) band 10 CDMA2000 Band Class 6 11 CDMA2000 Band Class 7
12 CDMA2000 Band Class 8 13 CDMA2000 Band Class 9 14 CDMA2000 Band Class 10 15 CDMA2000 Band Class 11 16 GSM 450 band 17 GSM 480 band 18 GSM 750 band 19 GSM 850 band 20 GSM Band 21 GSM PCS band 22 WCDMA I IMT 2000 band 23 WCDMA II PCS band 24 WCDMA III 1700 band 25 WCDMA IV 1700 band 26 WCDMA V US850 band 27 WCDMA VI JAPAN 800 band
28 Reserved for BC12/BC14 29 Reserved for BC12/BC14 30 Reserved 31 Reserved
Notes
Examples
USB730L AT Command Reference Guide 17
AT$NWBAND2
Command
AT$NWBAND2
Command Function
Reads the band preference <band-pref>. The band preference returned is read from NV item NV_BAND_PREF_32_63_I. Queries the possible bands <band>.
Query Syntax
AT$NWBAND2=?
Query Response
$NWBAND2: <band> bit definitions
Write Syntax
Write Response
Read Syntax
AT$NWBAND2?
Read Response
20000
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
<band_pref>
USB730L AT Command Reference Guide 18
<band>
1 WLAN US 2400 band 2 WLAN ETSI 2400 band 3 WLAN FRANCE 2400 band 4 WLAN SPAIN 2400 band 5 WLAN JAPAN 2400 band 6 WLAN US 2400 band 7 WLAN EUROPE 5000 band 8 WLAN FRANCE 5000 band 9 WLAN SPAIN 5000 band 10 WLAN JAPAN 5000 band 11 Reserved 12 Reserved 13 Reserved 14 Reserved 15 Reserved 16 Reserved 17 WCDMA EUROPE 2600 band 18 WCDMA EUROPE & JAPAN 900 band 19 WCDMA JAPAN 1700 band 20 Reserved for WLAN 20 Reserved for WLAN 21 Reserved for WLAN 21 Reserved for WLAN 22 Reserved for WLAN 23 Reserved for WLAN 24 Band Class 16 25 Reserved 26 Reserved 27 Reserved 28 Reserved 29 Reserved
Notes
Examples
USB730L AT Command Reference Guide 19
AT$NWCCMAUTOCONNECT
Command
AT$NWCCMAUTOCONNECT
Command Function
Changes auto connect option of the device.
Query Syntax
AT$NWCCMAUTOCONNECT=?
Query Response
AT$NWCCMAUTOCONNECT= <auto connect option (0-3)>
Write Syntax
Write Response
Read Syntax
Read Response
Execute Syntax
AT$NWCCMAUTOCONNECT=<auto connect option>
Execute Response
OK
Unsolicited Response
Parameter Values
<auto connect option>
0 ­1 ­2 ­3 -
Notes
Examples
USB730L AT Command Reference Guide 20
AT$NWCCMCONNECT
Command
AT$NWCCMCONNECT
Command Function
Connects or disconnects on ECM/RNDIS Interface.
Query Syntax
AT$NWCCMCONNECT=?
Query Response
$NWCCMCONNECT= <0-connect-disconnect>,<PDP_IP_type:0-v4 1-v6 2-
Write Syntax
Write Response
Read Syntax
Read Response
Execute Syntax
AT$NWCCMCONNECT=<0-connect/1- disconnect>,<PDP_IP_type:0-v4 1­v6 2- v4v6>
Execute Response
OK
Unsolicited Response
Parameter Values
<connect/disconnect>
0 - connect 1 - disconnect
<PDP_IP_type>
0 - v4 1 - v6 2 -v4v6
Notes
Examples
USB730L AT Command Reference Guide 21
AT$NWCFT
Command
AT$NWCFT
Command Function
Reads or sets up the COPS response format.
Query Syntax
AT$NWCFT=?
Query Response
NWCFT: 0,1
Write Syntax
AT$NWCFT=<mode>
Write Response
OK
Read Syntax
AT$NWCFT?
Read Response
NWCFT: 12
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
<mode>
0 – Novatel COPS Format 1 – 3GPP COPS Format
Notes
Examples
USB730L AT Command Reference Guide 22
AT$NWCHBAND
Command
AT$NWCHBAND
Command Function
Queries current Channel/Bandclass and allows unsolicited AT events reporting change in Channel/Bandclass.
Query Syntax
AT$NWCHBAND=?
Query Response
OK NWCHBAND: 0, 123
Write Syntax
Write Response
Read Syntax
AT$NWCHBAND?
Read Response
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
<Channel>
<Bandclass>
Notes
Device camps on LTE.
Examples
USB730L AT Command Reference Guide 23
AT$NWCID
Command
AT$NWCID
Command Function
Gets the cell ID and LAC (local access code) from current modes.
Query Syntax
AT$NWCID=?
Query Response
NWCID: (0/xxxx,yyyy/,zzzz) 0-ERROR , xxxx,yyyy - Cellid, LAC , zzzz - only LAC
Write Syntax
Write Response
Read Syntax
AT$NWCID?
Read Response
NWCID: 18720,65534
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
<mode>
0 - ERROR xxxx,yyyy (Cellid, LAC) zzzz (LAC)
NOTE: If xxxx, yyyy or zzzz is 0xFFFF, it means invalid value.
Notes
Examples
USB730L AT Command Reference Guide 24
AT$NWCSLFILTER
Command
AT$NWCSLFILTER
Command Function
Returns whether scan list filtering is enabled or not. Also, enables or disables
Query Syntax
AT$NWCSLFILTER=?
Query Response
NWCSLFILTER: 0 (disabled),1 (enabled)
Write Syntax
AT$NWCSLFILTER=
Write Response
OK
Read Syntax
AT$NWCSLFILTER?
Read Response
NWCSLFILTER: 3489942284
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
<value>
0 - filtering disabled 1 - filtering enabled
Notes
Examples
USB730L AT Command Reference Guide 25
AT$NWDATAUSAGE
Command
AT$NWDATAUSAGE
Command Function
Connects to network to start Data Usage query process.
Query Syntax
AT$NWDATAUSAGE
Query Response
OK
Write Syntax
Write Response
Read Syntax
AT$NWDATAUSAGE?
Read Response
<state:0>,<type:Shared>,<limit:100>, <totalusage:0.630>,<lineusage:0.043>, <usagedate:2017-03-12T05:05>,<cycleendday:04/06/2017>,<uint:GB>
Execute Syntax
AT$NWDATAUSAGE
Execute Response
OK
Unsolicited Response
Parameter Values
Notes
This is used in Enterprise Mode.
Examples
USB730L AT Command Reference Guide 26
AT$NWDEGC
Command
AT$NWDEGC
Command Function
Queries the PMIC temperature (in degrees Celsius only).
Query Syntax
AT$NWDEGC=?
Query Response
$NWDEGC: <temp degC>
Write Syntax
Write Response
Read Syntax
AT$NWDEGC
Read Response
$nwdegc: 32 degC
Execute Syntax
Execute Response
Parameter Values
<temp degC>
Notes
Examples
USB730L AT Command Reference Guide 27
AT$NWDYNAMICSTATUS
Command
AT$NWDYNAMICSTATUS
Command Function
Queries dynamic (current) status of device. Information includes network, technology, connection status, signal, roaming, etc.
Query Syntax
Query Response
Write Syntax
Write Response
Read Syntax
AT$NWDYNAMICSTATUS?
Read Response
<network:Verizon Wireless>,<tech:11>,<connstate:3>,<roam:0>, <rssi:5>,<trafic:0>,<femto:0><simstate:3>, <unreadsms:0>,<gpsstate:1>, <duration:0>,<rx:0>,<tx:0>,<localip:192.168.1.1>
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
Notes
This is used in Enterprise Mode.
Examples
USB730L AT Command Reference Guide 28
AT$NWFID
Command
AT$NWFID
Command Function
Query Syntax
Query Response
Write Syntax
Write Response
Read Syntax
AT$NWFID?
Read Response
$NWFID: No FID $NWFID: SS060115900026
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
Notes
Examples
USB730L AT Command Reference Guide 29
AT$NWFOTASTATUS
Command
AT$NWFOTASTATUS
Command Function
Query FOTA status.
Query Syntax
Query Response
Write Syntax
Write Response
Read Syntax
AT$NWFOTASTATUS?
Read Response
<FOTA status:0>
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
<FOTA Status>
0 - No Status 1 - Ready to Install 2 - In Progress
3 - Success 4 - Failure
Notes
This is used in Enterprise Mode.
Examples
USB730L AT Command Reference Guide 30
AT$NWFWAPIVER
Command
AT$NWFWAPIVER
Command Function
Retrieves the FW API version of a particular release.
Query Syntax
AT$NWFWAPIVER=?
Query Response
OK
Write Syntax
Write Response
Read Syntax
AT$NWFWAPIVER?
Read Response
$NWFWAPIVER: 1.00
Execute Syntax
Execute Response
Unsolicited Response
Parameter Values
<API Version>
Notes
Examples
Loading...
+ 85 hidden pages