Quectel BC95 AT Commands Manual V2.0
Quectel_BC95_AT_Commands_Manual_V2.0
Quectel_BC95_AT_Commands_Manual_V2.0
Quectel_BC95_AT_Commands_Manual_V2.0
Quectel_BC95_AT_Commands_Manual_V2.0
User Manual: Pdf
Open the PDF directly: View PDF .
Page Count: 131
Download | |
Open PDF In Browser | View PDF |
BC95 AT Commands Manual NB-IoT Module Series Rev. BC95_AT_Commands_Manual_V2.0 Date: 2018-05-14 Status: Released www.quectel.com NB-IoT Module Series BC95 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_AT_Commands_Manual 1 / 130 NB-IoT Module Series BC95 AT Commands Manual About the Document History Revision Date Author Description 1.0 2016-11-16 Walker HAN/ Donald TANG Initial Walker HAN 1. Added AT+NCONFIG command 2. Updated description of Neul Hi2110 implementation for AT+COPS/CGATT/CGDCONT/NMGS/NRB/ NCDP/NTSETID 1.1 2016-12-14 1. 1.2 2017-01-04 Walker HAN 2. 3. 1.3 2017-01-13 Donald TANG Updated examples in Chapter 8 1. 1.4 2017-03-22 Hayden WANG/ Donald TANG 2. 3. 1.5 1.6 1.7 2017-04-24 2017-07-03 2017-08-09 Updated description of Neul Hi2110 implementation for AT+CEREG/COPS/CGAT/NCDP/NSOST/NPING Updated description of parameters for AT+COPS/ NCDP/NUESTATS/NEARFCN Updated example in Chapter 8.2 Updated description of parameters for AT+NUESTATS/NEARFCN Updated description of Neul Hi2110 implementation for AT+NBAND/NLOGLEVEL Updated examples in Chapter 8 Hayden WANG 1. Added AT+CCLK/NSOSTF commands 2. Updated description of parameters for AT+NQMGS/ NEARFCN/NPING/NLOGLEVEL 3. Updated error values in Chapter 7 Miles MA/ Serena SHEN 1. Added AT+NATSPEED command 2. Updated description of BC95 implementation for AT+NSOCR/NBAND 3. Updated error values in Chapter 7 4. Updated examples in Chapter 8 Hayden WANG 1. Added following new AT commands: AT+CGACT/CPSMS/CEDRXS/CEER/CEDRXRDP/ CTZR/NMSTATUS/NCCID/NFWUPD 2. Added ETSI commands (127.005) in Chapter 4 3. Updated description of parameters for AT+CGSN/ BC95_AT_Commands_Manual 2 / 130 NB-IoT Module Series BC95 AT Commands Manual CEREG/CGDCONT/NUESTATS/NEARFCN/ NCONFIG 4. Added unsolicited information of MCU update state in Table 1 5. Updated error values in Chapter 7 Added reset reasons in Chapter 8 1.8 1.9 2.0 2017-09-18 2017-12-14 2018-05-14 Lebron LIU 1. Added following new AT commands: ATI/ATE/ AT+NPOWERCLASS/AT+NPSMR/AT+NPTWEDRXS 2. Updated description of parameters for following AT commands: AT+NMSTATUS/AT+NUESTATS/ AT+NEARFCN/AT+NATSPEED 3. Deleted AT commands AT+NRDCTRL and AT+NCHIPINFO Gary TANG/ Hayden WANG 1. Added following new AT commands: AT+CIPCA/AT+CGAPNRC/AT+QSECSWT/ AT+QSETPSK/AT+QLWULDATAEX/ AT+QLWULDATASTATUS 2. Updated description of +NSONMI commands. 3. Deleted AT+NTSETID command 4. Added description of AT commands for Huawei’s IoT platform 5. Added example of sending/receiving/reading messages via Huawei’s IoT platform 6. Updated description of parameters for AT+CEREG/ AT+CPSMS/AT+CEDRXS/AT+CEDRXRDP/ AT+NPTWEDRXS Gary TANG 1. Added following new AT commands: AT+CGAUTH/AT+NPIN/AT+NCSEARFCN 2. Updated description of parameters for AT+NPSMR/ AT+QSECSWT/AT+QSETPSK/AT+QLWULDATAEX 3. Added maximum response time for all AT commands 4. Added example for AT+NPING 5. Updated description of error responses BC95_AT_Commands_Manual 3 / 130 NB-IoT Module Series BC95 AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 4 Table Index ................................................................................................................................................... 7 1 Introduction .......................................................................................................................................... 8 1.1. Definitions .................................................................................................................................. 9 1.2. AT Command Syntax ................................................................................................................. 9 1.3. AT Command Responses ........................................................................................................ 10 1.4. 3GPP Compliance ................................................................................................................... 10 2 Implementation Status ...................................................................................................................... 11 3 3GPP Commands (27.007) ................................................................................................................ 15 3.1. ATI Display Product Identification Information ...................................................................... 15 3.2. ATE Set Command Echo Mode ............................................................................................ 16 3.3. AT+CGMI Request Manufacturer Identification .................................................................... 17 3.4. AT+CGMM Request Manufacturer Model ............................................................................ 17 3.5. AT+CGMR Request Manufacturer Revision ......................................................................... 18 3.6. AT+CGSN Request Product Serial Number ......................................................................... 20 3.7. AT+CEREG EPS Network Registration Status ..................................................................... 21 3.8. AT+CSCON Signalling Connection Status ........................................................................... 25 3.9. AT+CLAC List Available Commands .................................................................................... 27 3.10. AT+CSQ Get Signal Strength Indicator ................................................................................ 28 3.11. AT+CGPADDR Show PDP Addresses ................................................................................. 30 3.12. AT+COPS PLMN Selection .................................................................................................. 31 3.13. AT+CGATT PS Attach or Detach .......................................................................................... 35 3.14. AT+CGACT Activate or Deactivate a PDP Context .............................................................. 36 3.15. AT+CIMI Request International Mobile Subscriber Identity.................................................. 38 3.16. AT+CGDCONT Define a PDP Context ................................................................................. 39 3.17. AT+CFUN Set Phone Functionality ...................................................................................... 43 3.18. AT+CMEE Report Mobile Termination Error ......................................................................... 45 3.19. AT+CCLK Return Current Date & Time ................................................................................ 46 3.20. AT+CPSMS Power Saving Mode Setting ............................................................................. 47 3.21. AT+CEDRXS eDRX Setting .................................................................................................. 50 3.22. AT+CEER Extended Error Report ........................................................................................ 53 3.23. AT+CEDRXRDP eDRX Read Dynamic Parameters ............................................................ 54 3.24. AT+CTZR Time Zone Reporting ........................................................................................... 56 3.25. AT+CIPCA Initial PDP Context Activation ............................................................................. 58 3.26. AT+CGAPNRC APN Rate Control ........................................................................................ 60 3.27. AT+CGAUTH Define PDP Context Authentication Parameters ........................................... 62 4 ETSI Commands (27.005) .................................................................................................................. 64 4.1. AT+CSMS Select Messaging Service .................................................................................. 64 BC95_AT_Commands_Manual 4 / 130 NB-IoT Module Series BC95 AT Commands Manual 4.2. 4.3. 4.4. 4.5. 4.6. 4.7. AT+CNMA New Message Acknowledgement to ME/TA ....................................................... 66 AT+CSCA Service Centre Address ....................................................................................... 67 AT+CMGS Send SMS Messages ......................................................................................... 68 AT+CMGC Send SMS Command......................................................................................... 70 AT+CSODCP* Send Originating Data via Control Plane ..................................................... 71 AT+CRTDCP* Report Terminating Data via Control Plane .................................................. 73 5 General Commands ........................................................................................................................... 75 5.1. AT+NRB Reboot the Module ................................................................................................ 75 5.2. AT+NUESTATS Query UE Statistics ..................................................................................... 75 5.3. AT+NEARFCN Specify Search Frequencies ........................................................................ 80 5.4. AT+NSOCR Create a Socket................................................................................................ 81 5.5. AT+NSOST SendTo Command (UDP Only) ......................................................................... 82 5.6. AT+NSOSTF SendTo Command with Flags (UDP Only) ..................................................... 83 5.7. AT+NSORF Receive Command (UDP Only)........................................................................ 84 5.8. AT+NSOCL Close a Socket .................................................................................................. 86 5.9. +NSONMI Indicator of Arrived Socket Messages (Response Only) .................................... 87 5.10. AT+NPING Test IP Network Connectivity to a Remote Host ................................................ 87 5.11. AT+NBAND Set Supported Bands........................................................................................ 88 5.12. AT+NLOGLEVEL Set Debug Logging Level ........................................................................ 90 5.13. AT+NCONFIG Configure UE Behaviour ............................................................................... 91 5.14. AT+NATSPEED Configure UART Port Baud Rate ............................................................... 92 5.15. AT+NCCID Card Identification .............................................................................................. 94 5.16. AT+NFWUPD Firmware Update via UART .......................................................................... 95 5.17. AT+NPOWERCLASS Set the Mapping for Band and Power Class ..................................... 96 5.18. AT+NPSMR Power Saving Mode Status Report .................................................................. 97 5.19. AT+NPTWEDRXS Paging Time Window Value and eDRX Setting ..................................... 98 5.20. AT+NPIN PIN Operation ..................................................................................................... 101 5.21. AT+NCSEARFCN Clear Stored EARFCN .......................................................................... 103 6 Huawei's IoT Platform Commands ................................................................................................. 105 6.1. Description of Huawei's IoT Platform Commands ................................................................. 105 6.1.1. AT+NCDP Configure and Query CDP Server Settings ............................................ 105 6.1.2. AT+QSECSWT Set Data Encryption Mode .............................................................. 106 6.1.3. AT+QSETPSK Set PSK ID and PSK ........................................................................ 108 6.1.4. AT+NMGS Send Messages ...................................................................................... 109 6.1.5. AT+NMGR Get Messages ........................................................................................ 110 6.1.6. AT+NNMI New Message Indications ........................................................................ 110 6.1.7. AT+NSMI Sent Message Indications ........................................................................ 112 6.1.8. AT+NQMGR Query Received Messages ................................................................. 113 6.1.9. AT+NQMGS Query Sent Messages ......................................................................... 113 6.1.10. AT+NMSTATUS Message Registration Status ......................................................... 114 6.1.11. AT+QLWULDATAEX Send CON/NON Messages .................................................... 115 6.1.12. AT+QLWULDATASTATUS Query CON Messages Sending Status ......................... 116 7 Error Values ...................................................................................................................................... 118 BC95_AT_Commands_Manual 5 / 130 NB-IoT Module Series BC95 AT Commands Manual 8 Reset Reasons ................................................................................................................................. 121 9 Examples .......................................................................................................................................... 122 9.1. Attach Network ...................................................................................................................... 122 9.2. Send/Receive/Read UDP Messages .................................................................................... 126 9.3. Send/Receive/Read Messages via Huawei's IoT Platform ................................................... 127 10 Appendix A Reference..................................................................................................................... 129 BC95_AT_Commands_Manual 6 / 130 NB-IoT Module Series BC95 AT Commands Manual Table Index TABLE 1: UNSOLICITED INFORMATION OF UE UPDATE STATE INDICATION ............................................. 8 TABLE 2: AT COMMAND SYNTAX ..................................................................................................................... 9 TABLE 3: TYPES OF AT COMMANDS AND IMPLEMENTATION STATUS ...................................................... 11 TABLE 4: GENERAL ERRORS (27.007).......................................................................................................... 118 TABLE 5: GENERAL ERRORS (127.005) ....................................................................................................... 118 TABLE 6: SPECIFIC ERROR CODES ............................................................................................................ 120 TABLE 7: POSSIBLE REBOOT MESSAGES DISPLAYED ............................................................................ 121 TABLE 8: TERMS AND ABBREVIATIONS ...................................................................................................... 129 BC95_AT_Commands_Manual 7 / 130 NB-IoT Module Series BC95 AT Commands Manual 1 Introduction This document gives details of the AT Command Set supported by Quectel NB-IoT BC95 module. 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 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 8 for more details. In case that an external MCU intervenes in the process of firmware update via DFOTA, unsolicited information will inform the external MCU the current update state. Table 1: Unsolicited Information of 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 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 is successful, and update state has been reported to firmware package server. Update is done after this information. BC95_AT_Commands_Manual 8 / 130 NB-IoT Module Series BC95 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 are 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 Set Command AT+ =p1[,p2[,p3[.....]]] Set 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. For B600, the AT command processor uses carriage return/line feed pairs (\r\n, 0x0D0A) to end lines on its output. BC95_AT_Commands_Manual 9 / 130 NB-IoT Module Series BC95 AT Commands Manual If no command is entered after the AT token, "OK" will be returned. If an invalid command is entered, “ERROR” or “+CME 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" or "ERROR" or “+CME ERROR: ” indicating that it is ready to accept a new command. Solicited informational responses are sent before the final "OK" or "ERROR" or “+CME ERROR: ”. Responses will be of the format: +CMD1: OK Or OK 1.4. 3GPP Compliance 3GPP commands are complied with the 3GPP TS 27.007 v14.3.0 (2017-03). BC95_AT_Commands_Manual 10 / 130 NB-IoT Module Series BC95 AT Commands Manual 2 Implementation Status Table 3: Types of AT Commands and Implementation Status Description Implementation Status1) ATI Display Product Identification Information B657SP2 or later ATE Set Command Echo Mode B657SP2 or later AT+CGMI Request Manufacturer Identification B350 or later AT+CGMM Request Manufacturer Model B350 or later AT +CGMR Request Manufacturer Revision B350 or later AT+CGSN Request Product Serial Number B350 or later AT+CEREG EPS Network Registration Status B350 or later AT+CSCON Signalling Connection Status B350 or later AT+CLAC List Available Commands B350 or later AT+CSQ Get Signal Strength Indicator B350 or later AT+CGPADDR Show PDP Addresses B350 or later AT+COPS PLMN Selection B350 or later AT+CGATT PS Attach or Detach B350 or later AT+CGACT Activate or Deactivate PDP Context B657SP1 or later AT+CIMI Request International Mobile Subscriber Identity B350 or later AT+CGDCONT Define a PDP Context B350 or later AT+CFUN Set Phone Functionality B350 or later AT Command 3GPP Commands (27.007) BC95_AT_Commands_Manual 11 / 130 NB-IoT Module Series BC95 AT Commands Manual AT+CMEE Report Mobile Termination Error B600 or later AT+CCLK Return Current Date & Time B656 or later AT+CPSMS Power Saving Mode Setting B657SP1 or later AT+CEDRXS eDRX Setting B657SP1 or later AT+CEER Extended Error Report B657SP1 or later AT+CEDRXRDP eDRX Read Dynamic Parameters B657SP1 or later AT+CTZR Time Zone Reporting B657SP1 or later AT+CIPCA Initial PDP Context Activation B657SP3 or later AT+CGAPNRC APN Rate Control B657SP3 or later AT+CGAUTH Define PDP Context Authentication Parameters B657SP5 or later AT+CSMS Select Messaging Service B657SP1 or later AT+CNMA New Message Acknowledgement to ME/TA B657SP1 or later AT+CSCA Service Centre Address B657SP1 or later AT+CMGS Send SMS Messages B657SP1 or later AT+CMGC Send SMS Command B657SP1 or later AT+CSODCP* Send Originating Data via the Control Plane B657SP1 or later AT+CRTDCP* Report Terminating Data via the Control Plane B657SP1 or later AT+NRB Reboot the Terminal B350 or later AT+NUESTATS Query UE Statistics B350 or later AT+NEARFCN Specify Search Frequencies B350 or later AT+NSOCR Create a Socket B350 or later AT+NSOST SendTo Command (UDP Only) B350 or later AT+NSOSTF SendTo Command with Flags (UDP Only) B656 or later ETSI Commands (27.005) General Commands BC95_AT_Commands_Manual 12 / 130 NB-IoT Module Series BC95 AT Commands Manual AT+NSORF Receive Command (UDP only) B350 or later AT+NSOCL Close a Socket B350 or later +NSONMI Indicator of Arrived (Response Only) AT+NPING Test IP Network Connectivity to a Remote Host B350 or later AT+NBAND Set Supported Bands B600 or later AT+NLOGLEVEL Set Debug Logging Level B600 or later AT+NCONFIG Configure UE Behaviour B650 or later AT+NATSPEED Configure UART Port Baud Rate B656 or later AT+NCCID Card Identification B657SP1 or later AT+NFWUPD Firmware Update via UART B657SP1 or later AT+NPOWERCLASS Set the Mapping for Band and Power Class B657SP2 or later AT+NPSMR Power Saving Mode Status Report B657SP2 or later AT+NPTWEDRXS Paging Time Window Value and eDRX Setting B657SP2 or later AT+NPIN PIN Operation B657SP5 or later AT+NCSEARFCN Clear Stored EARFCN B657SP5 or later Socket Message B350 or later Huawei’s IoT Platform Commands AT+NCDP Configure and Query CDP Server Settings B350 or later AT+QSECSWT Set Data Encryption Mode B657SP3 or later AT+QSETPSK Set PSK ID and PSK B657SP3 or later AT+NMGS Send Messages B350 or later AT+NMGR Get Messages B350 or later AT+NNMI New Message Indications B350 or later AT+NSMI Sent message Indications B350 or later AT+NQMGR Query Received Messages B350 or later AT+NQMGS Query Sent Messages B350 or later BC95_AT_Commands_Manual 13 / 130 NB-IoT Module Series BC95 AT Commands Manual AT+NMSTATUS Message Registration Status B657SP1 or later AT+QLWULDATAEX Send CON/NON Messages B657SP3 or later AT+QLWULDATASTATUS Query CON Messages Sending Status B657SP3 or later NOTES 1. "*" means the commands listed in this chapter are under development. 2. 1) "B657SPx" (in which "x" indicates 1, 2, 3 or 5) refers to the protocol core version of the module which can be queried by AT+CGMR command. BC95_AT_Commands_Manual 14 / 130 NB-IoT Module Series BC95 AT Commands Manual 3 3GPP Commands (27.007) 3.1. ATI Display Product Identification Information The execution command returns product identification information. Please refer to Chapter 7 for possible values ATI Display Product Identification Information Execution Command ATI Response Quectel