Quectel BC95 G BC68 AT Commands Manual V1.2
User Manual:
Open the PDF directly: View PDF .
Page Count: 155
Download | |
Open PDF In Browser | View PDF |
BC95-G&BC68 AT Commands Manual NB-IoT Module Series Rev. BC95-G&BC68_AT_Commands_Manual_V1.2 Date: 2018-07-04 Status: Released www.quectel.com NB-IoT Module Series BC95-G&BC68 AT Commands Manual Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. 7th Floor, Hongye Building, No.1801 Hongmei Road, Xuhui District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://quectel.com/support/technical.htm Or email to: support@quectel.com GENERAL NOTES QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION PROVIDED IS BASED UPON CUSTOMERS‟ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO CHANGE WITHOUT PRIOR NOTICE. COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL WIRELESS SOLUTIONS CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2018. All rights reserved. BC95-G&BC68_AT_Commands_Manual 1 / 154 NB-IoT Module Series BC95-G&BC68 AT Commands Manual About the Document History Revision 1.0 1.1 1.2 Date Author Description 2017-12-28 Hayden WANG/ Gary TANG/ Arnold ZHAO Initial Oven TAO/ Waner PAN/ Hayden WANG/ Donald TANG 1. Added the following AT commands: AT+NQSOS/ +NSOCO/+NSOSD/+NMGS/+NMGR/+NNMI/ +NSMI/+NQMGR/+NQMGS/+NMSTATUS 2. Updated parameter and/or example description for the following AT commands: AT+CGMR/ +CGDCONT/+CNMA/+NUESTATS/+NSOCR/ +NSOST/+NSOSTF/+NCONFIG/+NPTWEDRXS/+ QLWSREGIND/+QLEDMODE/+QLWSREGIND/+QL WULDATA/+QLWULDATAEX/ +QLWULDATASTATUS/+QLWFOTAIND/ 3. Added examples in Chapter 9.2. 4. Deleted URC +QLWULDATAEXIND. Hayden WANG/ Evan WU/ Donald TANG 1. Added the following AT commands: AT+ +CGCONTRDP/CGAUTH/CNMPSD/+NCSEARFCN /+NIPINFO/+NCPCDPR/+NQPODCP/+QDNS/+QR ESETDTLS/+QDTLSSTAT/+QBOOTSTRAPHOLDO FF/+QLWSERVERIP/+QSETBSPSK/ +QBSSECSWT. 2. Added the following URC: +NSOCLI. 3. Updated the parameter and example description for the following AT commands: AT +NSOCR/ +NBAND/+NFWUPD/+NPOWERCLASS. 4. Updated error values in Chapter 6. 5. Updated the display of reboot message. 6. Deleted the original Chapter 2. 7. Updated/added examples in Chapter 8. 2018-03-15 2018-07-04 BC95-G&BC68_AT_Commands_Manual 2 / 154 NB-IoT Module Series BC95-G&BC68 AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index ................................................................................................................................................... 6 1 Introduction .......................................................................................................................................... 7 1.1. Definitions .................................................................................................................................. 8 1.2. AT Command Syntax ................................................................................................................. 8 1.3. AT Command Responses .......................................................................................................... 9 1.4. 3GPP Compliance ..................................................................................................................... 9 2 3GPP Commands (27.007) ................................................................................................................ 10 2.1. ATI Display Product Identification Information ...................................................................... 10 2.2. ATE Set Command Echo Mode ............................................................................................ 11 2.3. AT+CGMI Request Manufacturer Identification .................................................................... 12 2.4. AT+CGMM Request Manufacturer Model ............................................................................ 12 2.5. AT+CGMR Request Manufacturer Revision ......................................................................... 13 2.6. AT+CGSN Request Product Serial Number ......................................................................... 14 2.7. AT+CEREG EPS Network Registration Status .................................................................... 16 2.8. AT+CSCON Signalling Connection Status ........................................................................... 19 2.9. AT+CLAC List Available Commands .................................................................................... 21 2.10. AT+CSQ Get Signal Strength Indicator ................................................................................ 22 2.11. AT+CGPADDR Show PDP Addresses ................................................................................. 24 2.12. AT+COPS PLMN Selection .................................................................................................. 25 2.13. AT+CGATT PS Attach or Detach .......................................................................................... 28 2.14. AT+CGACT Activate or Deactivate PDP Context ................................................................. 29 2.15. AT+CIMI Request International Mobile Subscriber Identity.................................................. 31 2.16. AT+CGDCONT Define a PDP Context ................................................................................. 32 2.17. AT+CFUN Set UE Functionality ............................................................................................ 35 2.18. AT+CMEE Report UE Error .................................................................................................. 36 2.19. AT+CCLK Return Current Date and Time ............................................................................ 38 2.20. AT+CPSMS Power Saving Mode Setting ............................................................................. 39 2.21. AT+CEDRXS eDRX Setting .................................................................................................. 41 2.22. AT+CEER Extended Error Report ........................................................................................ 44 2.23. AT+CEDRXRDP eDRX Read Dynamic Parameters ............................................................ 45 2.24. AT+CTZR Time Zone Reporting ........................................................................................... 47 2.25. AT+CIPCA Initial PDP Context Activation ............................................................................. 49 2.26. AT+CGAPNRC APN Rate Control ........................................................................................ 51 2.27. AT+CSODCP* Sending Originating Data via the Control Plane .......................................... 53 2.28. AT+CRTDCP* Reporting Terminating Data via the Control Plane ....................................... 55 2.29. AT+CGCONTRDP Read PDP Context Dynamic Parameters .............................................. 57 2.30. AT+CGAUTH Define PDP Context Authentication Parameters ........................................... 59 2.31. AT+CNMPSD No More PS Data........................................................................................... 60 BC95-G&BC68_AT_Commands_Manual 3 / 154 NB-IoT Module Series BC95-G&BC68 AT Commands Manual 3 3GPP Commands (27.005) ................................................................................................................ 62 3.1. AT+CSMS Select Message Service ..................................................................................... 62 3.2. AT+CNMA New Message Acknowledgement to UE............................................................. 64 3.3. AT+CSCA Service Centre Address ....................................................................................... 66 3.4. AT+CMGS Send SMS Message ........................................................................................... 67 3.5. AT+CMGC Send SMS Command......................................................................................... 68 4 General Commands ........................................................................................................................... 70 4.1. AT+NRB Reboot the UE ....................................................................................................... 70 4.2. AT+NUESTATS Query UE Statistics .................................................................................... 70 4.3. AT+NEARFCN Specify Search Frequencies ........................................................................ 76 4.4. AT+NSOCR Create a Socket................................................................................................ 77 4.5. AT+NSOST SendTo Command (UDP Only) ......................................................................... 78 4.6. AT+NSOSTF SendTo Command with Flags (UDP Only) ..................................................... 79 4.7. AT+NQSOS Query the List of Pending Socket Message ..................................................... 81 4.8. AT+NSORF Receive Command ........................................................................................... 82 4.9. AT+NSOCO Connect Command (TCP Only) ....................................................................... 83 4.10. AT+NSOSD Send Command (TCP Only) ............................................................................ 84 4.11. AT+NSOCL Close a Socket .................................................................................................. 85 4.12. +NSONMI Indicator of Arrived Socket Message (Response Only) ...................................... 86 4.13. +NSOCLI Socket Close Indicator (Response Only) ............................................................. 87 4.14. AT+NPING Test IP Network Connectivity to a Remote Host ................................................ 87 4.15. AT+NBAND Set Supported Bands........................................................................................ 88 4.16. AT+NLOGLEVEL Set Debug Logging Level ........................................................................ 90 4.17. AT+NCONFIG Configure UE Behaviour ............................................................................... 91 4.18. AT+NATSPEED Configure UART Port Baud Rate ............................................................... 94 4.19. AT+NCCID USIM Card Identification .................................................................................... 96 4.20. AT+NFWUPD Firmware Update via UART .......................................................................... 97 4.21. AT+NPOWERCLASS Set the Mapping for Band and Power Class ..................................... 98 4.22. AT+NPSMR Power Saving Mode Status Report .................................................................. 99 4.23. AT+NPTWEDRXS Paging Time Window Value and eDRX Setting ................................... 101 4.24. AT+NPIN* PIN Operator ..................................................................................................... 104 4.25. AT+NCSEARFCN Clear Stored EARFCN .......................................................................... 105 4.26. AT+NIPINFO IP Address Information Report ..................................................................... 106 4.27. AT+NCPCDPR Configure PDP Context Dynamic Parameters to be Read ....................... 108 4.28. AT+NQPODCP Query Pending Originating Data List via the Control Plane ..................... 110 4.29. AT+QLEDMODE Set NETLIGHT LED Function Mode .......................................................111 4.30. AT+QDNS Trigger DNS Domain Name Resolution ............................................................ 112 5 Huawei’s IoT Platform Commands................................................................................................. 114 5.1. AT+NCDP Configure and Query CDP Server Settings ...................................................... 114 5.2. AT+QSECSWT Set Data Encryption Mode ........................................................................ 115 5.3. AT+QSETPSK Set PSK ID and PSK .................................................................................. 116 5.4. AT+QLWSREGIND Register Control .................................................................................. 117 5.5. AT+QLWULDATA Send Data .............................................................................................. 118 BC95-G&BC68_AT_Commands_Manual 4 / 154 NB-IoT Module Series BC95-G&BC68 AT Commands Manual 5.6. 5.7. 5.8. 5.9. 5.10. 5.11. 5.12. 5.13. 5.14. 5.15. 5.16. 5.17. 5.18. 5.19. 5.20. 5.21. 5.22. 5.23. AT+QLWULDATAEX Send CON/NON Message ................................................................ 119 AT+QLWULDATASTATUS Query CON Messages Sent Status ......................................... 120 AT+QLWFOTAIND Set DFOTA Update Mode .................................................................... 121 AT+QREGSWT Set Registration Mode .............................................................................. 122 AT+NMGS Send a Message ............................................................................................... 123 AT+NMGR Get a Message ................................................................................................. 124 AT+NNMI New Message Indications .................................................................................. 125 AT+NSMI Send Message Indications ................................................................................. 126 AT+NQMGR Query the Status of Messages Received ...................................................... 127 AT+NQMGS Query the Status of Messages Sent.............................................................. 128 AT+NMSTATUS Message Registration Status ................................................................... 129 +QLWEVTIND LwM2M Event Report (Response Only) .................................................... 130 AT+QRESETDTLS Reset DTLS Mode ............................................................................... 131 AT+QDTLSSTAT Query the State of DTLS ........................................................................ 132 AT+QBOOTSTRAPHOLDOFF* Bootstrap Hold off Time ................................................... 133 AT+QLWSERVERIP Set/Delete Bootstrap/LwM2M Server IP ........................................... 134 AT+QSETBSPSK* Configure PSK ID and PSK to Bootstrap............................................. 135 AT+QBSSECSWT* Configure Bootstrap Server Connection Switches ............................. 137 6 Error Values ...................................................................................................................................... 139 7 Reboot Reasons ............................................................................................................................... 142 8 Examples .......................................................................................................................................... 144 8.1. Network Attachment .............................................................................................................. 144 8.1.1. Automatic Network Attachment ................................................................................... 144 8.1.2. Manual Network Attachment ........................................................................................ 145 8.2. Send/Receive/Read a UDP Message ................................................................................... 146 8.3. Send/Receive/Read a TCP Message .................................................................................... 147 8.4. Examples Relating to Huawei‟s IoT Platform ........................................................................ 148 8.4.1. Register to Huawei‟s IoT Platform ............................................................................... 148 8.4.2. Send/Receive Data with Huawei‟s IoT Platform .......................................................... 149 8.4.3. Upgrade Firmware on Huawei‟s IoT Platform ............................................................. 150 8.4.4. Register to Huawei‟s IoT Platform with DTLS ............................................................. 152 9 Appendix A Reference..................................................................................................................... 153 BC95-G&BC68_AT_Commands_Manual 5 / 154 NB-IoT Module Series BC95-G&BC68 AT Commands Manual Table Index TABLE 1: UNSOLICITED INFORMATION FOR UE UPDATE STATE INDICATION .......................................... 7 TABLE 2: AT COMMAND SYNTAX ..................................................................................................................... 8 TABLE 3: GENERAL ERRORS (27.007)......................................................................................................... 139 TABLE 4: GENERAL ERRORS (27.005)......................................................................................................... 139 TABLE 5: SPECIFIC ERROR CODES ............................................................................................................ 141 TABLE 6: REBOOT MESSAGES DISPLAYED ............................................................................................... 142 TABLE 7: TERMS AND ABBREVIATIONS ...................................................................................................... 153 BC95-G&BC68_AT_Commands_Manual 6 / 154 NB-IoT Module Series BC95-G&BC68 AT Commands Manual 1 Introduction This document gives details of the AT Command Set supported by Quectel NB-IoT BC95-G and BC68 modules. The following string will be output after booting the module:Neul OK After this string has been received, the AT command processor is ready to accept AT commands. If BC95-G/BC68 module is rebooted or restarted for any reason that is not a normal power-on sequence, a message that indicates the reason for the reboot would be output before the Neul OK string. Please refer to Chapter 7 for more details. In case that an external MCU intervenes in the process of firmware update via DFOTA, unsolicited information will be output to inform the external MCU the current update state. Table 1: Unsolicited Information for UE Update State Indication Unsolicited Information Description FIRMWARE DOWNLOADING Indicates that UE is downloading update package. FIRMWARE DOWNLOAD FAILED Indicates that the download failed. FIRMWARE DOWNLOADED Indicates that the download finished. FIRMWARE UPDATING Indicates that the UE is updating. FIRMWARE UPDATE SUCCESS Indicates that the update is successful, but update state has not been reported to firmware package server yet. FIRMWARE UPDATE FAILED Indicates that the update failed. FIRMWARE UPDATE OVER Indicates that the update has been completed, and the update state has been reported to firmware package server. Update is done after this information. BC95-G&BC68_AT_Commands_Manual 7 / 154 NB-IoT Module Series BC95-G&BC68 AT Commands Manual NOTE During updating procedure, the module should not be operated until "FIRMWARE UPDATE OVER" is reported. For instance, executing AT+NRB to power off the module is not permitted, otherwise an error will occur. 1.1. Definitions : Carriage return character; : Line feed character; <..>: Parameter name. Angle brackets do not appear on command line; [..]: Optional parameter. Square brackets do not appear on the command line. 1.2. AT Command Syntax Table 2: AT Command Syntax Test Command AT+ =? Check possible sub-parameter values Read Command AT+ ? Check current sub-parameter values Write Command AT+ =p1[,p2[,p3[..... ]]] Write command Execution Command AT+ Execution command Multiple commands can be placed on a single line using a semi-colon (“;”) between commands. Only the first command should have AT prefix. Commands can be in upper or lower case. When entering AT commands spaces are ignored except in the following cases: Within quoted strings, where they are preserved; Within an unquoted string or numeric parameter; Within an IP address; Within the AT command name up to and including a „=‟, „?‟ or „=?‟. They can be used to make the input more human-readable. On input, at least a carriage return is required. A newline character is ignored so it is permissible to use carriage return/line feed pairs on the input. If no command is entered after the AT token, "OK" will be returned. If an invalid command is entered, BC95-G&BC68_AT_Commands_Manual 8 / 154 NB-IoT Module Series BC95-G&BC68 AT Commands Manual “ERROR” will be returned. Optional parameters, unless explicitly stated, need to be provided up to the last parameter being entered. 1.3. AT Command Responses When the AT command processor has finished processing a line, it will output "OK", "ERROR" or “+CME ERROR: ” to indicate that it is ready to accept a new command. Solicited informational responses are sent before the final "OK", "ERROR" or “+CME ERROR: ”. Responses will be in the format of: +CMD1: OK Or OK 1.4. 3GPP Compliance 3GPP commands are complied with the 3GPP TS 27.007 v14.3.0 (2017-03). BC95-G&BC68_AT_Commands_Manual 9 / 154 NB-IoT Module Series BC95-G&BC68 AT Commands Manual 2 3GPP Commands (27.007) 2.1. ATI Display Product Identification Information The execution command returns product identification information. Please refer to Chapter 6 for possible values. ATI Display Product Identification Information Execution Command ATI Response Quectel